home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / mta_vf10.zip / MTADOCEN.DOC < prev    next >
Text File  |  1992-05-03  |  349KB  |  6,588 lines
  1. ╔══════════════════════════════                 ┌─────────────────┐
  2. ║ MTA       Make Them Anything                  │    D.I.S.P.     │────┐
  3. ║           Convert Compressed                  │                 │░░░░│
  4. ╟──────────────────────────────                 │                 │░░░░│
  5. ║ (c) 1992  Robert W.van Hoeven                 │ Dutch           │░░░░│
  6. ╟──────────────────────────────                 │   Independent   │░░░░│
  7. ║ Release : 15.10                               │     ShareWare   │░░░░│
  8. ║ Rel.Date: 3th May 1992                        │       Programmer│░░░░│
  9. ╠══════════════════════════════                 └─────────────────┘░░░░│
  10. ║                                               |    │░░░░░░░░░░░░░░░░░│
  11. ║ │ MTA.EXE / MTM.EXE                           |    └─────────────────┘
  12. ║ │ MTL.EXE / MTZ.EXE                           |       ┌─────┐        |
  13. ║ │ MTA.CTL / MTA.CHx                           |       │░░░░░│        |
  14. ║ │                                             |       └──┬──┘        |
  15. ║ │ MTAOVR.EXE / MTAOVR.OVR (*)                 |     ┌────┴────┐      |
  16. ║ │                                             ------││││││ ═══│-------
  17. ║ │ Lines starting with '│' are                       └─────────┘
  18. ║ │ changes to release 15.08
  19. ║ │
  20. ║ │
  21. ╠═══════════════════════════════
  22. ║ Address: Robert W. van Hoeven
  23. ║          PO. Box 131
  24. ║          1170 AC  Badhoevedorp
  25. ║          Nederland / Holland
  26. ╚═══════════════════════════════
  27.  
  28. ╔═══════════════════════ (*) OVERLAY FILES ════════════════════════════╗
  29. ║ MTAOVR.EXE and MTAOVR.OVR are files that make the overlayed version  ║
  30. ║ of MTA. These files are available in a separate package which can be ║
  31. ║ found under the name MTAOVvvv.eee (where vvv has the same number as  ║
  32. ║ the last 3 digits of this archive (e.g. F10, F11, F32) and eee is    ║
  33. ║ the extension.                                                       ║
  34. ╚══════════════════════════════════════════════════════════════════════╝
  35.  
  36. ╔══════════════════════════════════════════════════════════════════════╗
  37. ║ READ THE Q&A.MTA FILE. IT CONTAINS UP-TO-DATE (AND CHANGING) ANSWERS ║
  38. ║ TO FREQUNTLY ASKED QUESTIONS ABOUT MTA.                              ║
  39. ╚══════════════════════════════════════════════════════════════════════╝
  40.  
  41.  ┌───────┬─────────────────────────────────────────────────────────────┐
  42.  │   0   │ Table of contents                                           │
  43.  └───────┴─────────────────────────────────────────────────────────────┘
  44.  
  45.  1 ----    General information
  46.   1.1      Copyrights and License Agreement
  47.   1.2      Newer versions and contacting the author
  48.  
  49.  2 ----    Package description and requirements
  50.   2.1      Preface
  51.   2.2      Requirements
  52.   2.3      Included files
  53.   2.4      History
  54.  
  55.  3 ----    Installation description
  56.   3.1      Installation
  57.   3.2      Archivers
  58.    3.2.1   General remarks and suggestions on archivers
  59.    3.2.2   Remarks on ARC
  60.    3.2.3   Remarks on PAK
  61.    3.2.4   Remarks on ZIP
  62.    3.2.5   Remarks on PKPAK/PKUNPAK
  63.    3.2.6   Remarks on DWC
  64.    3.2.7   Remarks on ZOO
  65.    3.2.8   Remarks on LHarc
  66.    3.2.9   Remarks on LArc
  67.    3.2.10  Remarks on MD
  68.    3.2.11  Remarks on ARJ
  69.    3.2.12  Remarks on HYPER
  70.    3.2.13  Remarks on PKLITE
  71.    3.2.14  Remarks on GIFLITE
  72.    3.2.15  Remarks on JPEG
  73.    3.2.16  Remarks on GIFTEST
  74.   3.3      MTA.CTL
  75.    3.3.1   Basic statements
  76.    3.3.2   Statements that define the environment that MTA uses (paths)
  77.    3.3.3   Statements that define the logging
  78.    3.3.4   Statements that define the selection of files
  79.    3.3.5   Statements that define the resulting files
  80.    3.3.6   Your own (new) compressor
  81.    3.3.7   Statements that define the various exits (hooks) in MTA
  82.    3.3.8   Statements that are useful to Bulletin Board Systems/SysOp's
  83.    3.3.9   Special statements
  84.    3.3.10  Statements available when using a registered version
  85.   3.4      Diskette option
  86.   3.5      KeyBoard control
  87.   3.6      Running multiple copies of MTA at the same time
  88.   3.7      Compression of single executable files (PKLITE)
  89.   3.8      The MTA tag-window
  90.   3.9      MTA and unattended operations
  91.   3.10     TICK-files and related material
  92.   3.11     FES, yet another TICK-clone ?
  93.   3.12     Special ARC considerations
  94.   3.13     Using newer versions of archivers
  95.  
  96.  4 ----    Run-time information
  97.   4.1      Command-line parameters
  98.    4.1.1   Command-line parameters that stand on their own
  99.    4.1.2   Command-line parameters that overrule/toggle/disable MTA.CTL
  100.    4.1.3   Command-line parameters with a special usage
  101.   4.2      Aborting MTA
  102.   4.3      LOG file
  103.   4.4      Errors
  104.  
  105.  5 ----    Version information and credits
  106.   5.1      The BETA-team
  107.   5.2      Credits
  108.   5.3      Version history
  109.   5.4      Copyright, Trademarks
  110.  
  111.  ┌───────┬─────────────────────────────────────────────────────────────┐
  112.  │   1   │ General information                                         │
  113.  └───────┴─────────────────────────────────────────────────────────────┘
  114.  
  115.  1.1 Copyrights and License Agreement
  116.  ────────────────────────────────────
  117.  
  118.  - Users of the MTA-package must accept this disclaimer of warranty:
  119.  
  120.  - The  MTA-package  is  supplied  as  is.   The  author  disclaims  all
  121.    warranties, expressed or implied, including, without limitation,  the
  122.    warranties of merchantability  and of fitness  for any purpose.   The
  123.    author assumes  no liability  for damages,  direct or  consequential,
  124.    which may result from the use of the MTA-package;
  125.  
  126.  - The  MTA-package  is  a  "shareware  program"  and is provided at  no
  127.    charge to the user for evaluation.   Feel free to share it with  your
  128.    friends,  but  please  do  not  give  it  away  altered or as part of
  129.    another  system.   The  essence  of  "user-supported"  software is to
  130.    provide personal  computer users  with quality  software without high
  131.    prices, and yet to provide  incentive for programmers to continue  to
  132.    develop new products.
  133.  
  134.  - If  you find  this program  useful and  find that  you are  using and
  135.    continue the  use of  the MTA-package  after a  30 days trial period,
  136.    you must register the MTA-package as described below;
  137.  
  138.  - Non-commercial can get a license for the usage up to this release  of
  139.    the MTA-package for  a small amount  of money. Look  into the details
  140.    in  REGISTER.MTA.  Previous  registered  users  will  receive  a  big
  141.    reduction to upgrade to the  newer versions. These users should  look
  142.    into the details in UPGRADE.MTA.   For Non-commercial users there  is
  143.    a POSSIBILITY to submit to one of the special contracts as  explained
  144.    in the file REGISTER.MTA.
  145.  
  146.  - Commercial usage of  MTA will cost somewhat  more. Also, a so  called
  147.    'closed' Bulletin  Board System  (a system  where the  user must  pay
  148.    direct to the  SysOp to get  full access) is  has to pay  more than a
  149.    Non-commercial  user.  Both  types  of  users  should  look  into the
  150.    details in REGISTER.MTA;
  151.  
  152.  - The registration of the MTA-package will license ONE copy for use  on
  153.    any computer at any  one time, as long  as the usage confirms  to the
  154.    type of registration you have done (so NON-commercial usage when  you
  155.    have a non-commercial license);
  156.  
  157.  - Anyone  distributing  the  MTA-package  for any kind of remuneration
  158.    must  first   contact  the   Author   at   the  address   above   for
  159.    authorization.
  160.  
  161.  - You are  encouraged  to  pass a copy   of the MTA-package  along   to
  162.    your friends  for  evaluation.   Please  encourage  them to  register
  163.    their copy if they find that they can use it;
  164.  
  165.  - Support  on  MTA,  when  used  in  a  non-commercial environment,  is
  166.    available  by  means  of  written  letters  or by entering the inter-
  167.    national echomail area DISP;
  168.  
  169.  - Problems and suggestions can be entered in the FidoNet <tm>  Echomail
  170.    conference <tm> called DISP (international). Entering this echo  does
  171.    not  exclude  you  of  the  duty  to register the MTA-package, though
  172.    users who evaluate the product can enter the echo for questions;
  173.  
  174.  - The  MTA-package, all  programs, the  documentation and support-files
  175.    is  copyrighted  1990,92  by  Robert  W.  van  Hoeven,  PO.  Box 131,
  176.    Badhoevedorp 1170AC, Holland. All  rights are reserved. You  may copy
  177.    this  package  for  backup  purposes.  Also  you  may  copy and share
  178.    unmodified copies of the whole package, providing that the  copyright
  179.    notice    is    reproduced    and    included    on    all    copies.
  180.    Excluded from this statement  are the support-files written  by other
  181.    authors.  Please  refer  to  the  documentation of these programs for
  182.    copyrights and license agreements;
  183.  
  184.  - It  is  forbidden  to  modify,  adapt,  translate, reverse  engineer,
  185.    decompile  and/or  disassemble  the  software  in  the   MTA-package.
  186.    Patching the medium at  places that carry the  software is seen as  a
  187.    program change and is also forbidden. It is forbidden to create a  so
  188.    called 'bypass' to skip the original introduction screens and  delay.
  189.    Also it is forbidden  to use such a  'bypass' unless supplied by  the
  190.    author (Robert W. van Hoeven) himself;
  191.  
  192.  - Performing  any  of  the  illegal  actions as stated in the previous
  193.    lines,  is  a  theft  and  no  fair  play  to  the  author  and, more
  194.    important, to the registered users;
  195.  
  196.  - Bulletin Board  Systems that distribute  the MTA package  can convert
  197.    the WHOLE package  to any archive-system  they like but  all original
  198.    files must  be included  in the  new archive.  The MTA-package on the
  199.    Bulletin Board  can contain  at the  most 2  extra files. These files
  200.    can only be  a commercial for  that Bulletin Board  and/or validation
  201.    data that is presented  as a service to  all users and shall  have no
  202.    other functions;
  203.  
  204.  - After  the normal  trial period  of 30  days, you  must register  the
  205.    soft- ware (see REGISTER.MTA) or you must remove it from your PC;
  206.  
  207.  - Comments,  suggestions  and  bug  reports  are  welcome  and will  be
  208.    answered as soon I have the time  to do so. You can send me  a letter
  209.    of leave  a NetMail  <tm> message  named to  Rob Van.hoeven (mind the
  210.    point)  on  node  2:512/100  (RA  Support, Monster, Holland, SysOp is
  211.    Reinier de Groot).  When you want to send me normal mail, address  it
  212.    to:   Robert  W.  van  Hoeven,  PO.  Box  131,  1171 AC Badhoevedorp,
  213.    Holland;  Also  you  can  enter  messages  in  the  FidoNet <tm> DISP
  214.    Echomail <tm> area;
  215.  
  216.  
  217.  1.2 Newer versions and contacting the author
  218.  ───────────────────────────────────────────────────────────────────────
  219.  The newest version of  MTA is always available  at the DISP-HQ on  node
  220.  2:512/100.  MTA  is  also  distributed  thru  a  number of DISP support
  221.  nodes.  There are three ways of obtaining newer versions of MTA:
  222.  
  223.  
  224.  - Logging on at DISP-HQ or a support node
  225.    Look into the file SUPPORT.MTA for a full list of support nodes;
  226.  
  227.  - Logging on to a SDS node
  228.    MTA is distributed thru SDS/SDN, but only big minors (x.10, x.20  and
  229.    so on) and majors (14.01, 15.01  and so on) are submitted to  the SDS
  230.    distribution point in Holland;
  231.  
  232.  - Logging on to your own BBS;
  233.    Chances  are,  that  you  will  find  an older version (international
  234.    users) because it will take some time for the new version to  'bleed'
  235.    thru the net;
  236.  
  237.  - Update service;
  238.    You can enter a special update service (read REGISTER.MTA).
  239.  
  240.  
  241.  If you think you have found problems in MTA, or in any other case,  you
  242.  wish to contact the author, you can send me:
  243.  
  244.  - A letter to the address you can find in the header of this file;
  245.  
  246.  -  A  NetMail  <tm>  message  to  Rob Van.hoeven (please mind the point
  247.    between Van and Hoeven) at 2:512/100 or (better) 2:512/100.5;
  248.  
  249.  - A Message in the FidoNet <tm> DISP echomail <tm> area;
  250.  
  251.  ┌───────┬─────────────────────────────────────────────────────────────┐
  252.  │   2   │ Package description and requirements                        │
  253.  └───────┴─────────────────────────────────────────────────────────────┘
  254.  
  255.  2.1 Preface
  256.  ───────────────────────────────────────────────────────────────────────
  257.  MTA is a program that can  be helpful with the job to  convert archives
  258.  (compressed files) from one archive-system (ZIP, ARJ, LZH and such  are
  259.  called archive-systems) to another one.
  260.  
  261.  The   conversion   from   archive-systems    is   something   that   is
  262.  done frequently  on  BBS  systems.  Different  users  do  uploads   for
  263.  files  created  in   various   archive-systems.   The  SysOp    (System
  264.  Operator   of a  BBS) will  make these   files available  in only   one
  265.  system so all  users who  download   one  or  more  files,  only   need
  266.  one archive program to decompress the files.
  267.  
  268.  When  a   normal  user   visits  various   BBS's  that   all have their
  269.  own archive system,   she/he will   also get   a mixture   of different
  270.  files, created in different archive-systems. In this case MTA can  also
  271.  help.
  272.  
  273.  There a tons of features available in MTA. Some of them will only  have
  274.  a meaning for a SysOp, some of  them only for the normal user and  many
  275.  of them for  both. Users can  automatically remove files  from archives
  276.  (many BBS's add  headers and/or files  to the archive  as advertisement
  277.  for the BBS),  SysOp's can add  them, both can  scan for viri  (in many
  278.  different  ways).  There  are  options  to  convert  a  single  file, a
  279.  complete directory (with  or without sub-directories),  complete drives
  280.  and a  special feature  to convert  all files  on a  diskettes from one
  281.  system to another (while the user  won't have to worry that the  target
  282.  files will not fit on the diskette). The list can go on for hours.
  283.  
  284.  The MAJOR   benefit of   MTA is,   that it   treats ANY   of the   most
  285.  known  archivers  with   the  same   service.  Other   programs may  be
  286.  smaller  but only  treat a certain archive-system  for  the full  100%.
  287.  MTA  is  made   in  a   way   that   YOU   can   decide   what   output
  288.  (archive-system)  should  be  created  without   having  to  search for
  289.  better programs  when  you  swap from  one system  to  another. Another
  290.  benefit of  MTA   is the  up-to-date status  of the   program. For more
  291.  than 3  years   now, I  have   managed to  update MTA  at the same time
  292.  (and  sometimes  earlier)  you  got  hold   of  a  new  version of your
  293.  archive-program.  And even when you are  not served within the  minute,
  294.  you  can  always  use  the  special  routines  in MTA  that implement a
  295.  'user-type'  of  archive   program  (based  on  the  extension   of the
  296.  archives).
  297.  
  298.  MTA's documentation  is NOT  easy. It  is a  large text.  There are  so
  299.  many options that can be   useful for you. The   best way to start   is
  300.  to read  everything one  (without   the description  of   the options),
  301.  then  take a ASCII-editor, import chapter   3 and start  to create  the
  302.  configuration  file,  line  by  line,  option  by  option.  If you have
  303.  completed the   setup, you nearly  don't have   to look at  it  anymore
  304.  for a long  time, so take your time.
  305.  
  306.  
  307.  2.2 Requirements
  308.  ───────────────────────────────────────────────────────────────────────
  309.  MTA requires:      - PC XT/AT/386/486 (or more)
  310.                     - At least 400K free memory but it depends on the
  311.                       archiver(s) you use (NON OVERLAYED VERSION);
  312.                     - At least 200K free memory but it depends on the
  313.                       archiver(s) you use (OVERLAYED VERSION);
  314.                     - DOS 3.xx and higher;
  315.                       (tested with 4Dos 4.0, should work with lower
  316.                       versions);
  317.                     - DOS 2.xx ONLY when registered. In this case, a
  318.                       customized version will be created;
  319.                     - HDU optional
  320.                     - Mouse optional
  321.                     - One or more virus-scanners (optional)
  322.                     - The original (de)compression programs. MTA does
  323.                       NOT contain the compression/decompression
  324.                       routines;
  325.                     - The  original  GIF  conversion  programs that are
  326.                       supported by MTA;
  327.  
  328.  
  329.  2.3 Included files
  330.  ───────────────────────────────────────────────────────────────────────
  331.  The package includes : MTA.EXE         The main program
  332.                         MTA.CH1         The chained tag-menu module
  333.                         MTA.CH2         The chained help-menu module
  334.                         MTM.EXE         The maintenance program
  335.                         MTL.EXE         The list program
  336.                         MTA_DIR.EXE     The directory utility
  337.                         MTA_CRC.EXE     The VALIDATE caller
  338.                         MTA__BAT.EXE    A SFX with examples of batches
  339.                         MTA__UTL.EXE    A SFX with additional utilities
  340.  
  341.  Besides this normal and complete package, there is an additional  file,
  342.  containing MTAOVR.EXE and MTA.OVR. These are the files that are  needed
  343.  to run MTA in overlayed mode.
  344.  
  345.  
  346.  
  347.  2.4 History
  348.  ───────────────────────────────────────────────────────────────────────
  349.  MTA is  now 3  years old.  It started  with version  4.01 (first public
  350.  release). Releases 1, 2  and 3 were called  MTZ and could only  convert
  351.  ZIP-files. With  release 13,  MTA changed  from freeware  to shareware.
  352.  With release  14, MTA  added some  extra options  for BBS's  and became
  353.  able to output some of  the text to a modem  (so MTA could be run  as a
  354.  shell under the BBS or a protocol-driver). With release 15, a new  type
  355.  of compressed files is supported.  These are GIF files. Release  15 can
  356.  support  the  conversion  of  GIF  files.  Also,  within  release 15, a
  357.  MS/Windows version of MTA will  be released AND (finally) the  setup of
  358.  the configuration  file will  change from  a ASCII-file  to a  windowed
  359.  (full-screen) setup program  (not in 15.01,  15.01 is a  forced release
  360.  because of the upcoming ZIP 2.xx).
  361.  
  362.  I will try to  keep MTA  as  up-to-date as possible. Every  few  months
  363.  or so, new  versions  of  archive programs   hit the  market. Some   of
  364.  these versions  contain  new   algorithms  and  also  contain   changes
  365.  in the  internal structure.  Up to  now, I   was able  to release a new
  366.  version of MTA only   a few  days  after  the final   release of   such
  367.  versions   (and  sometimes  earlier,  based   on  the   beta-versions).
  368.  Needless to say  that it is a hell of a job to keep informed about  all
  369.  the changed.
  370.  
  371.  ┌───────┬─────────────────────────────────────────────────────────────┐
  372.  │   3   │ Installation description                                    │
  373.  └───────┴─────────────────────────────────────────────────────────────┘
  374.  
  375.  3.1 Installation
  376.  ───────────────────────────────────────────────────────────────────────
  377.  MTA is  not an  easy program  to install.  There are  numerous features
  378.  that can be used.  Also, there are no  specific guidelines for a  quick
  379.  install of the program,  but in the next  chapters I will try  to guide
  380.  you thru the installation in a structured way.
  381.  
  382.  The first step is  the installation of the  (program) files. This is  a
  383.  very easy step if  you observe all the  following points. The next  few
  384.  steps are described with a hard-disk system in mind:
  385.  
  386.  - Decide which directory you want to use. MTA can find its own  support
  387.    files in three possible ways (in the following order):
  388.  
  389.    - In the current directory;
  390.    - The directory containing MTA.EXE (DOS 3.xx and higher only);
  391.    - The DOS PATH (DOS 2.xx and higher);
  392.  
  393.    Either use an existing directory or create a new directory that  will
  394.    be used for the  installation of MTA (in  the second case, add  it to
  395.    the DOS PATH,  so the call  to MTA.EXE can  be done from  anywhere on
  396.    the disk);
  397.  
  398.  - Place MTA.EXE, MTA.CH1, MTA.CH2, MTL.EXE, MTM.EXE and MTZ.EXE in  the
  399.    selected directory.  If you  don't want  to use  MTL, MTM and/or MTZ,
  400.    you  can  always   remove  them  later.   MTA.CH1  and  MTA.CH2   are
  401.    (sometimes) needed  by MTA.  MTA.CH1 contains  the interactive  pick-
  402.    list to select files  from a large list,  MTA.CH2 is called when  you
  403.    want help information about  the command-line options. When  you have
  404.    obtained the overlayed version of MTA, you must also copy  MTAOVR.EXE
  405.    and MTA.OVR to  the selected directory.  All programs CAN  be renamed
  406.    to anything you like (e.g.  delete the non-overlayed MTA.EXE and  re-
  407.    name  the  overlayed  MTAOVR.EXE  to  MTA.EXE) but the files MTA.CH1,
  408.    MTA.CH2 can NOT be renamed. Also when you rename the overlay  version
  409.    (MTAOVR.EXE), you should give  the  filename-part (not the extension)
  410.    of the overlay file (MTAOVR.OVR) the SAME name (so  rename MTAOVR.EXE
  411.    to BLURB.EXE, in that case, rename MTAOVR.OVR to BLURB.OVR);
  412.  
  413.  - Copy the  included example of  MTA.CTL to the  same directory as  the
  414.    MTA program files. This example file must be changed later on to  you
  415.    own environment and needs. For now, leave it unchanged;
  416.  
  417.  - MTA can  also look for  an environment variable  called MTA. You  can
  418.    add a line  in AUTOEXEC.BAT with  the value 'SET  MTA=[path]' (do not
  419.    code the  quotes and  replace [path]  with the  name of the directory
  420.    where MTA.EXE/CH1/CH2/OVR/CTL are;
  421.  
  422.  - NEVER  use compression  programs like  PKLITE, SHRINK  or DIET on the
  423.    executable files inside  the MTA package.  They must stay  unaltered.
  424.    The programs that are called within MTA (archivers, exits) can,  from
  425.    MTA's point of view, be compressed with these programs;
  426.  
  427. │- Be sure to have the DOS program SUBST.COM/EXE inside your DOS path.
  428. │  This program comes with your release  of DOS and without them,  MTA
  429. │  can do  less of the  conversion than when  you have them available.
  430. │  As you will see later, you need special  options to set to a value
  431. │  to let  MTA make use of this program (so  you can still have  them
  432. │  on  the drive  without MTA  using them).  Unless you have a special
  433. │  configuration (network and such), you can rest  assure that you can
  434. │  use these programs along with MTA for 90% of the  normal
  435. │  configurations;
  436.  
  437.  - When  installing the  MTA files,  also take  some time  to see  which
  438.    archive programs  you have  where (write  them down,  because you can
  439.    use this  info when  you create  MTA.CTL). Also  take a  look at  the
  440.    versions  you  run  of  these  programs.   The  next chapters will go
  441.    into  specific  details  for  every  supported  archiver.  In case of
  442.    difficulty  or  just  to  stay  up-to-date,  you should try to obtain
  443.    the highest version that is mentioned in the documentation;
  444.  
  445.  - When using the overlayed version, you can set the size of the overlay
  446.    buffer.  Normally  this is not needed (in which case you will get the
  447.    maximum  number of free bytes) but when this slows down too much, you
  448.    can use the  MTAOVRSZ environment variable to reset the value. Normal
  449.    operations wil l need a size of 53000 bytes (given or take a few). If
  450.    you supply 'SET MTAOVRSZ=0'  in  your  AUTOEXEC.BAT, MTA will use the
  451.    smallest  possible  number of bytes for the overlay buffer. Using the
  452.    'SET MTAOVRSZ=100000' for example, will cause the overlay to run much
  453.    faster but also use 50K of extra (CONVENTIONAL) memory;
  454.  
  455.  
  456.  3.2 Archivers
  457.  ───────────────────────────────────────────────────────────────────────
  458.  In the next chapters I will give some personal advise and some  remarks
  459.  on the various archivers that  are available and that MTA  can support.
  460.  If  you  are  an  inexperienced  user,  you can obtain some information
  461.  about archivers you haven't looked at, if you are a pro, you will  find
  462.  some remarks on the  various archivers that have  to deal with the  way
  463.  MTA converts from and to these kind of systems.
  464.  
  465.  
  466.  3.2.1 General remarks and suggestions on archivers
  467.  ───────────────────────────────────────────────────────────────────────
  468.  This  chapter   (3.2.1)  contains   some  PERSONAL   information  about
  469.  archivers in general. If you don't  know all the systems or if  you are
  470.  still in  search for  a better  one, this  chapter can  guide you  in a
  471.  certain way.  I won't start a discussion about the information in  this
  472.  chapter, neither with  the authors (beta-testers)  nor with the  users,
  473.  remember it  is my  personal point  of view,  after looking  at all  of
  474.  them. For starters, I  will URGE to say  that MTA supports ALL  archive
  475.  systems in the  BEST possible way,  so the fact  that I am  not using a
  476.  certain system does  not mean that  MTA does not  support it for  100%.
  477.  Some  other  vendors  supply  conversion  programs  from  all  (or one)
  478.  systems to all  (or one) other  system. Please be  warned that most  of
  479.  these programs ar  written with a  certain archive system  in mind. MTA
  480.  is not such a  program. I neither sell  nor develop any archive  system
  481.  myself  so  MTA  can  look  as  'objective'  as possible to any archive
  482.  system.
  483.  
  484.  The question 'which is the best  archive system for my situation' is  a
  485.  question that is  asked many times.  I can not  give 100% OK  answer to
  486.  this question but I can try. First you must ask yourself one  question.
  487.  WHY, besides  gaining disk  space,   should I  use an  archive program.
  488.  Here are some guidelines:
  489.  
  490.  -a) I  need as  much files  in on  my disks,  so HIGH compression is my
  491.      major goal;
  492.  
  493.  -b) I  want  to  create  compressed  files very quickly because I  have
  494.      either a slow machine or much archives to maintain;
  495.  
  496.  -c) I  want  to  make  my  archives  'transparent'  to  other types of
  497.      operating systems (called 'platforms' with a difficult word);
  498.  
  499.  -d) I need  to archive (and  store) files on  diskette that are  bigger
  500.      than my highest diskette format;
  501.  
  502.  -e) I want  some sort of  version control, so  when I add  a file to an
  503.      archive, any previous file with  the same name inside that  archive
  504.      must be kept as a backup (older level);
  505.  
  506.  I  am  sure  there  are  some  other  guidelines  to follow. For one, I
  507.  personally  like  a  good  and  bug-free  archive  program  with a good
  508.  feedback from users of  vendor when needed. But  let us take the  given
  509.  guidelines (a) to (e) and see what COULD be best for you. In the  given
  510.  order:
  511.  
  512.  -a) Most archivers can  compress to a very  small format but there  are
  513.      three groups  that differ  in size.  The first  group contains  ZIP
  514.      (2.xx),  LZH  (2.xx)  and  ARJ  (2.xx)  in  a random order. It is a
  515.      matter of 1  to 3 percent  depending on the  kind of files.  LZH is
  516.      free (with source-code) which can  be a bonus but also  a drawback.
  517.      The second group  contains ZOO (2.xx),  HYPER (25) and  PAK (2.xx).
  518.      ZOO 2.1x  is somewhere  between the  first and  second group, other
  519.      differ in speed and options. The remaining systems are combined  as
  520.      the third group;
  521.  
  522.  -b) When speed is  the main interest, ZIP  is your goal. LZH  (2.xx) is
  523.      also good and some of the  older systems can work fast. There  is a
  524.      rule that says, the higher  the compression, the more time  it will
  525.      take to  compress. Where  ARJ, ZIP  and LZH  make very com- pressed
  526.      files (within a the 5% bounds), ZIP outruns the others;
  527.  
  528.  -c) If  you want  to make  'portable' archives,  the choices are small.
  529.      Excluding OS/2  and to  my knowledge,  only LZH  and ZOO can create
  530.      transparent archives. ARJ  is working on  one and the  archives are
  531.      already prepared to be transparent;
  532.  
  533.  -d) For  this  feature  you  need  the so called multi-volume  support.
  534.      Only ARJ and ZIP (2.xx) support multi-volume support (MTA does  not
  535.      by the way);
  536.  
  537.  -e) Version  control is  an option  in demand  by programmers.  ARJ and
  538.      ZOO include  version control.  ZOO in  a somewhat  nicer way as ARJ
  539.      but   it  has  just  been  included  in  ARJ,  so there is room for
  540.      improvements;
  541.  
  542.  I think  that most  of the  users need  a combination  of -a)  and -b).
  543.  From the text you  can see that, unless  you need special tricks,  ARJ,
  544.  LZH and  ZIP are  the first  you should  try. If  you love many options
  545.  (and have a fast machine), you should take a look at ARJ.  If you  love
  546.  a good  simple interface  and very  speedy results,  ZIP is  your first
  547.  target and when  you want something  of both (and  the sources, AND  no
  548.  registration), LZH  would be  nice, though  it has  some drawbacks  (no
  549.  path-information, no  multi-volume). I  will skip  to ZIP  2.xx because
  550.  the AV-code is finally possible for non-USA users.
  551.  
  552.  
  553.  3.2.2 Remarks on ARC
  554.  ───────────────────────────────────────────────────────────────────────
  555.  MTA supports : All ARC versions up to 6.02
  556.  
  557.  There are no  special tricks concerning  ARC. When destination  is ARC,
  558.  FULL recursive support  is available if  you use the  SubstDrive option
  559.  in MTA.CTL, otherwise,  no recursive support  is available, due  to the
  560.  nature of ARC's recursive support.
  561.  
  562.  MTA is  NOT able  to detect  incoming encrypted  ARC-files. There is no
  563.  indication in the ARC whatsoever that an ARC-file is encrypted.  Please
  564.  be careful ! MTA IS able  to unARC encrypted ARC-files when you  supply
  565.  the correct switches to MTA;
  566.  
  567.  If you receive  files from the  newer (7.xx) version  of ARC (SEA)  but
  568.  you don't own ARC  7.xx, you can use  the UNARCPath option in  MTA.EXE.
  569.  This option can point to either ARCE.EXE or XARC.EXE. In that case  you
  570.  can decompress the  files and convert  them to another  system that you
  571.  CAN support.
  572.  
  573.  
  574.  3.2.3 Remarks on PAK
  575.  ───────────────────────────────────────────────────────────────────────
  576.  MTA supports : All PAK versions up to 2.51
  577.  
  578.  There are a  few things to  keep in mind  when using a  PAK version. If
  579.  you still use GSARC (the old PAK),  skip as fast as you can to  a newer
  580.  level (GSARC support will be removed from MTA, somewhere in 1992).
  581.  
  582.  There are some special tricks concerning PAK. When destination is  PAK,
  583.  FULL recursive support  is available if  you use the  SubstDrive option
  584.  in MTA.CTL, otherwise,  no recursive support  is available, due  to the
  585.  nature of PAK's recursive support.
  586.  
  587.  When adding comments to the PAK file (AutoComment option), up to  64000
  588.  bytes  are  allowed,  although  this  seems  to  be  more  than PAK can
  589.  support.
  590.  
  591.  MTA  is  NOT  able  to  detect  incoming  encrypted  PAK-files, see the
  592.  remarks on ARC files.
  593.  
  594.  NoGate Consulting  have released  a PAK  2.5x with  ZIP-support inside.
  595.  MTA is  NOT able  to use  PAK as  a substitution  for PKWare's ZIP. You
  596.  MUST use PKZIP/PKUNZIP to compress and decompress ZIP files !
  597.  
  598.  
  599.  3.2.4 Remarks on ZIP
  600.  ───────────────────────────────────────────────────────────────────────
  601.  MTA supports : All ZIP versions up to 2.01
  602.  
  603.  When using   ZIP files   (as destination),   you must   remember to set
  604.  the  correct  compression  switches  in   the  ZIPCompression option in
  605.  MTA.CTL.  You can not (of  course) use a switch  that is not  supported
  606.  with your current  version  of  ZIP.   Also  be  sure  to  upgrade   to
  607.  the  highest  possible  version.  MTA  versions  up   to  14.57 contain
  608.  upgrade  support   to  upgrade  from  older   ZIP  (0.xx) to  newer ZIP
  609.  (1.xx)  formats. MTA 15.01 and up  still contain  upgrade support   but
  610.  now  for the   1.xx to  2.xx  versions of ZIP. MTA   will ignore  newer
  611.  ZIP  archives if you still  use an older ZIP version.
  612.  
  613.  MTA  is  able  to  detect  and  process  both  encrypted  ZIP-files and
  614.  ZIP-files  with  Authenticity  Verification  set  to  ON. MTA will skip
  615.  encrypted ZIP-files when no password is supplied to MTA.
  616.  
  617. │From 14.50 and  on, conversion of  volume-labels from and  to ZIP files
  618. │is available in MTA.
  619.  
  620.  
  621.  3.2.5 Remarks on PKPAK/PKUNPAK
  622.  ───────────────────────────────────────────────────────────────────────
  623.  MTA supports : All PKPAK/UNPAK versions up to 3.61
  624.  
  625.  There is  nothing special  in this  support. To  go along  with S.E.A.,
  626.  PKPAK/PKUNPAK  format  is  not  supported  as  destination, nor are the
  627.  (archive) comments inside a PKware created ARC-file;
  628.  
  629.  MTA is NOT able to  detect incoming encrypted PKPAK-files. There  is no
  630.  indication  in  the  ARC  whatsoever  that  a  PKPAK-file is encrypted.
  631.  Please be  careful !  MTA IS  able to  unPAK encrypted PKPAK-files when
  632.  you supply the correct switches to MTA.
  633.  
  634.  
  635.  3.2.6 Remarks on DWC
  636.  ───────────────────────────────────────────────────────────────────────
  637.  MTA supports : DWC version 5.10A
  638.  
  639.  No support for included directories.  You can set the type  of compress
  640.  (average, good) by means of the DWCCompression option in MTA.CTL.
  641.  
  642.  There are some special tricks concerning DWC. When destination is  DWC,
  643.  FULL recursive support  is available if  you use the  SubstDrive option
  644.  in MTA.CTL, otherwise,  no recursive support  is available, due  to the
  645.  nature of DWC's recursive support.
  646.  
  647.  MTA is able  to detect and  process DWC files  that are encrypted.  MTA
  648.  will skip an encrypted DWC-file when no password is supplied to MTA.
  649.  
  650.  
  651.  3.2.7 Remarks on ZOO
  652.  ───────────────────────────────────────────────────────────────────────
  653.  MTA supports : ZOO version 2.10
  654.  
  655.  There is nothing special in  this support. Full recursive and  relative
  656.  path support is  available. MTA also  supports ZOO 2.01  'extended' and
  657.  the new ZOO 2.10 with very small target files (high compression).
  658.  
  659.  You  can  set  high  compression  for  ZOO  by using the ZOOCompression
  660.  option with a value of h.
  661.  
  662.  When adding comments to the ZOO file (AutoComment option), up to  64000
  663.  bytes  are  allowed,  although  this  seems  to  be  more  than ZOO can
  664.  support.
  665.  
  666.  
  667.  3.2.8 Remarks on LHarc
  668.  ───────────────────────────────────────────────────────────────────────
  669.  MTA supports : All LHarc versions up to 2.13E
  670.  
  671.  There are some special tricks concerning LZH. When using LZH  (in/out),
  672.  FULL recursive support  is available if  you use the  SubstDrive option
  673.  in MTA.CTL, otherwise,  no recursive support  is available, due  to the
  674.  nature of LZH's recursive support.
  675.  
  676.  NEVER use versions 2.03 to 2.06. Please contact me if you want to  know
  677.  the details WHY MTA can not support these versions.
  678.  
  679.  Remember to set the LZHVersion option to the correct value !!!!!!!!!!
  680.  
  681.  
  682.  3.2.9 Remarks on LArc
  683.  ───────────────────────────────────────────────────────────────────────
  684.  MTA supports : LArc version 3.33
  685.  
  686.  MTA supports  LArc as  it can.  There is  no documentation available to
  687.  me, so everything comes from 'the dark'.
  688.  
  689.  There are some special tricks concerning LZS. When using LZS  (in/out),
  690.  FULL recursive support  is available if  you use the  SubstDrive option
  691.  in MTA.CTL, otherwise,  no recursive support  is available, due  to the
  692.  nature of LZS's recursive support.
  693.  
  694.  
  695.  3.2.10 Remarks on MD
  696.  ───────────────────────────────────────────────────────────────────────
  697.  MTA supports : MDCD version 1.00
  698.  
  699.  MTA supports MDCD. The  not so commonly used  MDCD program can be  used
  700.  both as source and as  target. Although the sources are  available, MTA
  701.  will use the stand-alone program MDCD.EXE for (de)compression.
  702.  
  703.  
  704.  3.2.11 Remarks on ARJ
  705.  ───────────────────────────────────────────────────────────────────────
  706.  MTA supports : ARJ  version 2.30
  707.  
  708.  Support for ARJ is rather straight forward. All standard functions  are
  709.  implemented but at  least ARJ 2.22  is needed because  MTA uses the  -+
  710.  option to switch off the SW_ARJ options.
  711.  
  712.  There is no  support for multi-volumes  and neither for  ARJ files with
  713.  backups  inside.  MTA  can  process  them correctly (even with extended
  714.  testing, see later) but it is up  to you what will happen. You can  set
  715.  the ARJCompression option in MTA to  whatever you like. If you add  the
  716.  -jo  switch,  ARJ  will   decompress  the  backup-versions  along   the
  717.  original, renaming the backup-versions.
  718.  
  719.  ARJ files with a security envelope  are supported but MTA will not  add
  720.  comments or files to these files  as with ZIP (ARJ disallows adding  of
  721.  these objects by reporting an invalid security envelope).
  722.  
  723.  ARJ contains the original  archive-name within the archive  itself. MTA
  724.  can use this  name and (optionally)  rename the source-archive  back to
  725.  that original name before conversion start (OriginalARJName option).
  726.  
  727.  Support for  the 2.10  volume labels  is added.  Please remember to put
  728.  the  KeepVolLabel  (/KEEPVL)  option  on  ONLY  in combination with ARJ
  729.  version 2.1x>. If you use ZIP  (1.1x>) and a lower version of  ARJ than
  730.  2.1x, conversion of the volume-labels  will cause ARJ to abort  and the
  731.  converted files to be moved to the error-directory !
  732.  
  733.  
  734.  3.2.12 Remarks on HYPER
  735.  ───────────────────────────────────────────────────────────────────────
  736.  MTA supports : HYPER version 25 (and up)
  737.  
  738.  This nice little  compression program from  Germany, is also  supported
  739.  in MTA. Testing  (to implement the  protocol in MTA)  gave results that
  740.  are in the same order as LHARC.
  741.  
  742.  MTA support the  recursive features in  HYPER. Any commenting  in a HYP
  743.  file is  impossible (yet)  and thus  not supported  by MTA. All comment
  744.  related features will do nothing on a HYP file.
  745.  
  746.  MTA will support HYPER SFX (self extracting archive) files.
  747.  
  748.  Also MTM, MTL and MTZ are changed to reflect the results of the  change
  749.  from or to HYPER and to do maintenance on these files.
  750.  
  751.  
  752.  3.2.13 Remarks on PKLITE
  753.  ───────────────────────────────────────────────────────────────────────
  754.  MTA supports : PKLITE version 1.15 (and up)
  755.  
  756.  It is a little off-topic type of program to be included in MTA, but  it
  757.  is. MTA (and  the selection-menu MTA.CH1)  is changed so  that you easy
  758.  convert  COM/EXE  files  to  compressed  (self-contained) COM/EXE files
  759.  with PKLITE. I think this is a useful bonus (and nothing more) to MTA.
  760.  
  761.  Why not  include LZEXE  you would  ask. The  reasons are  simple (and a
  762.  hint to the author, based on the current version 0.91):
  763.  
  764.  - LZEXE can only directly compress EXE files (COM files need a  special
  765.    conversion); - LZEXE can only go one way;
  766.  
  767.  In the near future I will think about adding the Japanese DIET  program
  768.  into MTA (it can do the same, and more, than PKLITE).
  769.  
  770.  When MTA  works in  (UN)PKLITE mode,  it can  only convert with PKLITE.
  771.  All other files (archives) are not converted.
  772.  
  773.  When MTA  ignores files  in the  selection, there  can be  a number  of
  774.  reasons. These are:
  775.  
  776.  With PKLITE:
  777.  
  778.  - The file is already PKLITE'ed;
  779.  
  780.  - The file is already LZEXE'ed;
  781.  
  782.  - The file is a SFX (Self extracting archive);
  783.  
  784.  With UNPKLITE:
  785.  
  786.  - The file is not PKLITE'ed;
  787.  
  788.  LZEXE files are left, because  it will create problems when  converting
  789.  these programs with PKLITE and when it does NOT create problems,  there
  790.  will be NO gain in size. SFX-files are left for the same reasons.
  791.  
  792.  
  793.  3.2.14 Remarks on GIFLITE
  794.  ───────────────────────────────────────────────────────────────────────
  795.  MTA supports : GIFLITE 1.41 (and up)
  796.  
  797.  With version 15.01,  MTA can also  convert GIF files.  There is support
  798.  for GIFLITE (registered and un-registered) without any drawbacks.
  799.  
  800.  
  801.  3.2.15 Remarks on JPEG
  802.  ───────────────────────────────────────────────────────────────────────
  803.  MTA supports : JPEG 15 (and up)
  804.  
  805.  There are various JPEG implementations. The one from Handmade  Software
  806.  is included for the moment.  The original programs from the  JPEG group
  807.  have reached DISP-HQ to late to be implemented.
  808.  
  809.  
  810.  3.2.16 Remarks on GIFTEST
  811.  ───────────────────────────────────────────────────────────────────────
  812.  MTA supports : GIFTEST 4.0ß
  813.  
  814.  MTA does  not use  any command-line  parameter in  the call to GIFTEST.
  815.  You can add some yourself (using MTA.CTL options and/or a  command-line
  816.  parameter for MTA). MTA is aware of all of the errorlevels that can  be
  817.  returned  by  GIFTEST.  If  you  include  command-line  parameters  for
  818.  GIFTEST that  cause the  GIF-file(s) to  be removed  if they are wrong,
  819.  MTA still try to move the file but without success. The only  'problem'
  820.  in this case, is the warning message you will receive. MTA is aware  of
  821.  all the errorlevels. 5 and 255 are converted to 'decompression  error'.
  822.  When you use  /L on the  GTECOMPRESSION option, be  sure to point  to a
  823.  place  (directory)  that  is  not  'owned'  by  MTA (so NOT the current
  824.  directory).  Use /M to  trigger when the dimensions are  not supported.
  825.  In that case MTA will move the file to the error-directory (lvl 20).
  826.  
  827.  
  828.  3.3 MTA.CTL
  829.  ───────────────────────────────────────────────────────────────────────
  830.  To let MTA  work, you must  create a configuration  file where MTA  can
  831.  obtain  the  information  it  needs.  This  file  is  called MTA.CTL by
  832.  default but can have any other  name (in which case you must  assign it
  833.  to MTA by means of  a command-line option or an  environment variable).
  834.  You can even have more configuration files for different tasks. If  you
  835.  call the file  MTA.CTL and place  it as described  in chapter 3.1,  MTA
  836.  will  find  it  without  the  use  of special forces like command-lines
  837.  and/or  environment  variables.  In  this  DOCUMENTATION  we refer to a
  838.  configuration file by its  original name (MTA.CTL). You  can substitute
  839.  your filename in place.
  840.  
  841.  The configuration  file is  a normal  ASCII-file (text  file) which you
  842.  can create and edit with line-editors like EDLIN or EDIT. You can  make
  843.  the  file  as  big  as  you  want (by inserting many comment-lines) but
  844.  remember that the size  has a relation with  the speed of reading  when
  845.  MTA starts.  Large files will take MTA to do longer over the startup.
  846.  
  847.  The general formats of options are:
  848.  
  849.  OPTION  parameter parameter parameter .... parameter
  850.  
  851.  for active options, or:
  852.  
  853.  % comment
  854.  
  855.  for comments in  the configuration file.  In the documentation  we call
  856.  the first parameter  'option' and the  secondary parameters are  called
  857.  'parameter'.  For  parameters,  the  following  syntax  is  used in the
  858.  description:
  859.  
  860.  [.....]   this  parameter is mandatory, it  MUST be present and  have a
  861.            valid value;
  862.  
  863.  {.....}   this  parameter  is   optional.  If  it is NOT present,  some
  864.            default is used;
  865.  
  866.  'value'   Values  between  quotes   must  be  coded WITHOUT the  quotes
  867.            itself UNLESS specified;
  868.  
  869.  (*)       If this mark   occurs at the  end of the  options syntax,  it
  870.            means that this option is  used by other programs in  the MTA
  871.            package as  well. In  that case  refer to  the bottom  of the
  872.            description to  see in  which program(s)  the option  is used
  873.            also;
  874.  
  875.  There are  NO restrictions  to the  position you  start the option, nor
  876.  the  starting  position  of  the  parameters,  but the 'option' and (if
  877.  present) the  'parameters' have  to be  separated with  at least one or
  878.  more spaces. You can make any mixture of upper and lower case !
  879.  
  880.  Some  of  the  parameters  in  the  MTA.CTL  file can be overruled with
  881.  command-line switches. A generalized example of MTA.CTL is included  in
  882.  the release-file. It contains ALL options available in this release.
  883.  
  884.  The following chapters will contain the several statements you can  use
  885.  in MTA.CTL.  In the  documentation, the  statements are  put in logical
  886.  groups.  These  groups  contain  statements  with  the  same  sort   of
  887.  functions  or  serve  the  same  group  of  users.  The ACTUAL order of
  888.  options in the configuration file does not matter at all.
  889.  
  890.  
  891.  3.3.1 Basic statements
  892.  ───────────────────────────────────────────────────────────────────────
  893.  The following options are more or less basic options and should be used
  894.  in any setup. Some of the statements can be left out, because they only
  895.  add something extra or change the default that MTA itself assumes.
  896.  
  897.  ┌─────────────────────────────────────────────────────────────────────┐
  898.  │ ARCPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  899.  │ UNARCPath   [path] {opt} {DynSwapSiz} {second path}                 │
  900.  │ PAKPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  901.  │ ZOOPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  902.  │ DWCPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  903.  │ LZHPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  904.  │ LZSPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  905.  │ PKZIPPath   [path] {opt} {DynSwapSiz} {second path}              (*)│
  906.  │ MDPath      [path] {opt} {DynSwapSiz} {second path}                 │
  907.  │ PKUNZIPPath [path] {opt} {DynSwapSiz} {second path}              (*)│
  908.  │ PKUNPAKPath [path] {opt} {DynSwapSiz} {second path}              (*)│
  909.  │ ARJPath     [path] {opt} {DynSwapSiz} {second path}              (*)│
  910.  │ HYPERPath   [path] {opt} {DynSwapSiz} {second path}              (*)│
  911.  │ PKLITEPath  [path] {opt} {DynSwapSiz} {second path}                 │
  912.  │ ZIP2EXEPath [path] {opt} {DynSwapSiz} {second path}                 │
  913.  │ GIFLITEPath [path] {opt} {DynSwapSiz} {second path}                 │
  914.  │ GIF2JPGPath [path] {opt} {DynSwapSiz} {second path}                 │
  915.  │ JPG2GIFPath [path] {opt} {DynSwapSiz} {second path}                 │
  916.  │ GIFTESTPath [path] {opt} {DynSwapSiz} {second path}                 │
  917.  └─────────────────────────────────────────────────────────────────────┘
  918.  Usage : These options point to the various archivers you have installed
  919.          on your system. If you do not include statements for  archivers
  920.          that ARE installed AND can  be found in the DOS-path,  MTA will
  921.          search for them itself, so do not be surprised if, for example,
  922.          you did not include the ZOOPath option but MTA is still able to
  923.          work with ZOO files. In that case MTA has found ZOO.EXE in  the
  924.          DOS-path !  If you  have all  archivers in  the DOS-path, it is
  925.          still advised to include  the options for these  archivers. MTA
  926.          will be able to pin-point  the archiver directly in this  case,
  927.          causing a gain  of speed because,  otherwise, MTA will  start a
  928.          'quest' for the archiver in the DOS-path.
  929.  
  930.          [Path]        This parameter must contain the drive,  directory
  931.                        and filename  of the  archiver in  question.  MTA
  932.                        will  validate  if  the  program  is at the given
  933.                        location  and  terminate  with  an  error  if  it
  934.                        isn't.
  935.  
  936.          {opt}         This  parameter  is optional. You  MUST  code  it
  937.                        when  one  of  the  following  parameters is used
  938.                        and/or if  you want  to change  the default. This
  939.                        parameter  must  have  a  value  of either 'Y' or
  940.                        'N'. The  value will  decide if  THIS archiver is
  941.                        going to  be included  when you  want to optimize
  942.                        your archive  on to  the smallest  size. All  the
  943.                        archive programs that  do COMPRESSION and  have a
  944.                        value of 'Y'  will be included  if you force  MTA
  945.                        to  optimize  on  size  (/OOA on the command-line
  946.                        or OptimizeOnSize  option in  MTA.CTL set).   'N'
  947.                        will  cause  MTA  to  skip  this  archiver   when
  948.                        optimize  is  running.  For  some  archivers  the
  949.                        value is  not important  because they  either can
  950.                        not COMPRESS (like PKUNZIP) or they have  nothing
  951.                        to do with  normal file-compression (GIFLITE  and
  952.                        such), but if  you code one  or more of  the next
  953.                        parameters you  still must  include a  'Y' or 'N'
  954.                        ('N' would be obvious.  'Y' is ignored) for  this
  955.                        parameter;
  956.  
  957.          {DynSwapSiz}  This parameter  will instruct MTA if  swapping is
  958.                        needed  before  the  (de)compression  program  is
  959.                        actually  called.  In  previous  releases,   this
  960.                        parameters was set to a fixed value ('SWAP')  but
  961.                        with  15.01  and  up,  MTA uses DYNAMIC swapping.
  962.                        You need to supply  the amount of memory  that is
  963.                        needed to  run the  specific archive  program. In
  964.                        the  included  example  of  MTA.CTL,  all minimal
  965.                        values that worked are  included. If you need  at
  966.                        least  250K  to  run  a specific archive program,
  967.                        you must  code '256'  (or higher)  over here. For
  968.                        some programs it is best to swap ALWAYS. In  this
  969.                        case  a  value  of  '640'  will  do, because that
  970.                        amount of CONVENTIONAL memory is NEVER  available
  971.                        when MTA is running,  causing MTA to always  swap
  972.                        before the archive  program is called.  With this
  973.                        option you are more or less save when MTA is  run
  974.                        from  a  secondary  shell.  Programs that need as
  975.                        much  memory  as  possible  are  GIG2JPG, JPG2GIF
  976.                        and, in some cases, ARJ.
  977.  
  978.          {second path} MTA (from 15.01)  can use two different sets  (or
  979.                        versions) of a specific archiver. If you use  the
  980.                        current PKZIP  and a  newer version  (or even  an
  981.                        alpha or  beta) is  released, you  normally would
  982.                        like  to  test  this  archiver  before  you start
  983.                        using it.  For this  situation, you  can use this
  984.                        parameter. You can rename your new version to  an
  985.                        alternate name (f.i. P2ZIP.EXE) or you can  place
  986.                        it in another directory.  When you have done  so,
  987.                        you  can  include  the  full  path  to  this  new
  988.                        program in  this parameter.  Now if  you run  MTA
  989.                        with  the  /ALT  command-line,  MTA  will use the
  990.                        program that is coded  over and not the  one that
  991.                        is coded in the [path] parameter. If there is  no
  992.                        {second  path}  option  included  but you run MTA
  993.                        with /ALT, the program in [path] is used;
  994.  
  995.          Please notice that you must supply the correct programs to  the
  996.          above  options.  If  you  replace  one  of  the  program's with
  997.          another one, strange things  (errors) can occur and  data could
  998.          corrupt.  Supply the following programs to the options:
  999.  
  1000.          ARCPath             ARC.EXE     or its alias
  1001.          UNARCPath           XARC.EXE    or its alias (see ARC remarks)
  1002.          PAKPath             PAK.EXE     or its alias
  1003.          ZOOPath             ZOO.EXE     or its alias
  1004.          DWCPath             DWC.EXE     or its alias
  1005.          LZHPath             LHARC.EXE   or its alias
  1006.          LZSPath             LARC.EXE    or its alias
  1007.          PKZIPPath           PKZIP.EXE   or its alias
  1008.          MDPath              MDCD.EXE    or its alias
  1009.          PKUNZIPPath         PKUNZIP.EXE or its alias
  1010.          PKUNPAKPath         PKUNPAK.EXE or its alias
  1011.                           or PKXARC.COM  or its alias
  1012.                           or PKXARC.EXE  or its alias
  1013.          ARJPath             ARJ.EXE     or its alias
  1014.          HYPERPath           HYPER.EXE   or its alias
  1015.          ZIP2EXEPath         ZIP2EXE.EXE or its alias
  1016.          GIFLITEPath         GIFLITE.EXE or its alias
  1017.          JPG2GIFPath         JPG2GIF.EXE or its alias
  1018.          GIF2JPGPath         GIF2JPG.EXE or its alias
  1019.          GIFTESTPath         GIFTEST.EXE or its alias
  1020.  
  1021.          Where 'alias'  is the  name you  renamed the  original file to.
  1022.          Please supply  the complete  drive, directory  and filename  to
  1023.          any of the options !  If you leave the drive  and/or directory,
  1024.          MTA will replace it with the CURRENT drive and/or directory.
  1025.  
  1026.          If you don't own one  or more of the (de)compression  programs,
  1027.          leave out the related option, otherwise MTA will abort !
  1028.  
  1029.  Relate: None
  1030.  Dest. : All
  1031.  (*)   : Marked options are also in usage by: MTM
  1032.  
  1033.  
  1034.  ┌─────────────────────────────────────────────────────────────────────┐
  1035.  │ CompressionType [ttt]                                               │
  1036.  └─────────────────────────────────────────────────────────────────────┘
  1037.  Usage : This option sets the normal TARGET archive system. You can,  at
  1038.          any time,  overrule this  target with  another target.  In that
  1039.          case you can supply the correct command-line to do so.
  1040.  
  1041.          [ttt]          This sets the target. You can supply the  values
  1042.                        'ARC',  'PAK',  'ZIP',  'ZOO', 'LZH' (LHarc/LHA),
  1043.                        'LZS' (Larc), 'DWC',  'HYP', 'ARJ', 'MD'  (MDCD),
  1044.                        'PAKSFX',    'ZIPSFX',    'LZHSFX',     'ARJSFX',
  1045.                        'PKLITE',   'UNPKLITE',   'GIFLITE',   'GIF2JPG',
  1046.                        'JPG2GIF',        'GIF'        and         'OWN'.
  1047.  
  1048.                        Most of  them look  normal. Some  of them  don't.
  1049.                        The  PAKSFX,  ZIPSFX,  LZHSFX  and ARJSFX are the
  1050.                        same as PAK,  ZIP, LZH and  ARJ but also  include
  1051.                        the  creation  of  an  EXE/COM  (SFX)  file.  The
  1052.                        PKLITE  can  be  used  to  convert  EXE  files to
  1053.                        PKLITE'ed  EXE  files,  the  UNPKLITE  does   the
  1054.                        reversed.  The  GIFLITE  will  convert normal GIF
  1055.                        files to GIFLITE GIF's.  The GIF2JPG can be  used
  1056.                        to convert GIF files  to JPG files with  JPEG and
  1057.                        JPG2GIF  does  the  reversed.  The value GIF will
  1058.                        cause MTA  to test  all GIF's  (normal and  lite)
  1059.                        with GIFTEST (no  conversion, other than  removal
  1060.                        of obsolete bytes, will be done).
  1061.  
  1062.                        OWN is  used when  you work  with a  special (not
  1063.                        normally supported  compression program,  see the
  1064.                        OWNxxxx options later on).
  1065.  
  1066.                        When set to  PKLITE/UNPKLITE, MTA will  only look
  1067.                        for  COM/EXE  files  that  can  be  converted  to
  1068.                        PKLITE or that are  converted with PKLITE.   When
  1069.                        set to  GIFLITE, GIF2JPG  or GIF,  MTA will  only
  1070.                        look  for  GIF  files,  when  set to JPG2GIF, MTA
  1071.                        will  only  look  for  files  with  the extension
  1072.                        '.JPG'. All other values  will cause MTA to  look
  1073.                        at all known archives.
  1074.  
  1075.          I suggest that you include  the most frequently used target  in
  1076.          MTA.CTL and use command-line switches to work with the  special
  1077.          ones  (so  set  CompressionType  to  ZIP  if ZIP is your normal
  1078.          target and use /PKLITE on  the command-line to let MTA  work on
  1079.          COM/EXE files when needed).
  1080.  
  1081.  Relate: None
  1082.  Dest. : All
  1083.  
  1084.  
  1085.  ┌─────────────────────────────────────────────────────────────────────┐
  1086.  │ LZHVersion [version] {alt version}                                  │
  1087.  │ PAKVersion [version] {alt version}                               (*)│
  1088.  │ ZIPVersion [version] {alt version}                               (*)│
  1089.  └─────────────────────────────────────────────────────────────────────┘
  1090.  Usage : These options set the version number for the various  archives.
  1091.          They are  needed because  the archivers  involved use different
  1092.          command-lines and/or internal  formats for different  versions.
  1093.          MTA can NOT auto-detect  the version-number (f.i. based  on the
  1094.          length of the  archive program) because  these programs can  be
  1095.          converted with PKLITE, DIET,  LZEXE or some other  EXE-compress
  1096.          program. You  MUST set  the manually  and you  MUST set them to
  1097.          the version you actually use !
  1098.  
  1099.          [version]     Must contain   the right  version. 1.10  must  be
  1100.                        translated to 110, 2.0  to 200, 1.13c to  113 and
  1101.                        so on.
  1102.  
  1103.          {alt version} If you use  the /ALT command-line option and  the
  1104.                        archiver  in  question  has  an alternate version
  1105.                        set  with  {second  path}  in the xxxPath option,
  1106.                        you  must  supply  the  version  number  of  this
  1107.                        program if  it is  not the  same as  the one  you
  1108.                        supplied  in  [version].  So  if  you  use   both
  1109.                        PKZIP.EXE (1.10) and  P2ZIP.EXE (2.01), you  must
  1110.                        code 'ZIPVersion 110 201'.  If you do not  supply
  1111.                        {alt version}, it will  be the same as  the value
  1112.                        set for [version] !
  1113.  
  1114.          Some  notes  about  the  various  differences between versions.
  1115.          For LZH, any value under 200  will cause MTA to give a  warning
  1116.          when a  2.xx archive  is found  (it will  skip the conversion).
  1117.          For ZIP, any value under 200  will cause MTA to give a  warning
  1118.          when a ZIP with a 2.xx format is detected (it will not  convert
  1119.          such a file). For PAK, the difference lies between 000  (GSArc)
  1120.          and 100 and  higher (GSArc does  not return an  errorlevel) and
  1121.          100-199 and 200 and higher (other formats in the PAK files).
  1122.  
  1123.          By default, MTA uses the versions 110 for ZIP, 251 for PAK  and
  1124.          213 for LHarc/LHA.
  1125.  
  1126.  Relate: None
  1127.  Dest. : LZH/PAK/ZIP
  1128.  (*)   : Marked options are also in usage by: MTM
  1129.  
  1130.  
  1131.  ┌─────────────────────────────────────────────────────────────────────┐
  1132.  │ ZIPCompression     [parm..parm]                                  (*)│
  1133.  │ ZSFCompression     [parm..parm]                                     │
  1134.  │ DWCCompression     [parm..parm]                                     │
  1135.  │ ARJCompression     [parm..parm]                                     │
  1136.  │ ASFCompression     [parm..parm]                                     │
  1137.  │ ZOOCompression     [parm..parm]                                     │
  1138.  │ LZHCompression     [parm..parm]                                     │
  1139.  │ LSFCompression     [parm..parm]                                     │
  1140.  │ PKLITECompression  [parm..parm]                                     │
  1141.  │ GIFLITECompression [parm..parm]                                     │
  1142.  │ G2JCompression     [parm..parm]                                     │
  1143.  │ J2GCompression     [parm..parm]                                     │
  1144.  │ GTECompression     [parm..parm]                                     │
  1145.  └─────────────────────────────────────────────────────────────────────┘
  1146.  Usage : These options can be  used to add some extra parameters  to the
  1147.          compression program. Normally MTA uses the standard  parameters
  1148.          for each program  but some of  the programs can  have alternate
  1149.          parameters to set the density of the compression, the usage  of
  1150.          BIOS/Direct screen calls,  the detail of  reporting and so  on.
  1151.          You can add these options yourself (some suggestions are  given
  1152.          below) by  means of  these statements.  Those archive  programs
  1153.          that are NOT included,  don't have any useful  extra parameters
  1154.          that MTA should pass.
  1155.  
  1156.          [parm..parm]  When  you include the  options, you must  set the
  1157.                        parameters you want to  ADD to the ones  that MTA
  1158.                        already  adds.  You  can  code  them  just as you
  1159.                        would do  when you  called the  program from  the
  1160.                        command-line.
  1161.  
  1162.           The following options can  be used to add  (overrule) command-
  1163.           line parameters to the specific program:
  1164.  
  1165.           ZIPCompression     for PKZIP/PKUNZIP
  1166.           ZSFCompression     for ZIP2EXE
  1167.           DWCCompression     for DWC
  1168.           ARJCompression     for ARJ
  1169.           ASFCompression     for ARJ (when creating SFX files)
  1170.           ZOOCompression     for ZOO
  1171.           LZHCompression     for LZH
  1172.           LSFCompression     for LZH (when creating SFX files)
  1173.           PKLITECompression  for PKLITE
  1174.           GIFLITECompression for GIFLITE
  1175.           G2JCompression     for GIF2JPG
  1176.           J2GCompression     for JPG2GIF
  1177.           GTECompression     for GIFTEST
  1178.  
  1179.          For ZIP you could add -es,  -en or -ex to overrule the  default
  1180.          type of  compression, for  ZOO you  could add  the 'h' for high
  1181.          compression (ZOO 2.1x),  for DWC you  could add the  'y' or 'z'
  1182.          for compression  on speed  or size,  of ARJ  the -jm1 parameter
  1183.          would be  nice and  also the  -jo statement  would be nice when
  1184.          you use  ARJ 2.3  and want  to convert  any backups  inside the
  1185.          archives  as  well.  For  LHarc  the  /o option would force the
  1186.          older (1.13) method and  so we can go  on for a while.  Be sure
  1187.          to  add  only  extra  parameters.  The obvious ones are already
  1188.          passed by MTA  itself. The parameters  for encrypted files  and
  1189.          for special work  directories (and drives)  are also passed  by
  1190.          MTA, depending on other options !
  1191.  
  1192.  Relate: None
  1193.  Dest  : All
  1194.  (*)   : Marked options are also in usage by: MTM
  1195.  
  1196.  
  1197.  ┌─────────────────────────────────────────────────────────────────────┐
  1198.  │ OriginalARJName                                                     │
  1199.  └─────────────────────────────────────────────────────────────────────┘
  1200.  Usage : ARJ  keeps the name  of the archive  (when created) inside  its
  1201.          own  internal  structure.  Normally  you  would  nor  have  any
  1202.          problem with that, but there are users who rename the ARJ to  a
  1203.          name that fits  their own needs  better. When you  include this
  1204.          option in MTA.CTL, MTA will  FIRST rename the file back  to the
  1205.          ORIGINAL name inside  the ARJ-structure BEFORE  conversion will
  1206.          start. This  could be  useful but  please be  warned that  some
  1207.          third  party  archive-conversion  programs  first  create   the
  1208.          archive with a  temporary name before  renaming it to  the name
  1209.          it should  be. In  such case  a file  DSZ1212.ARJ could also be
  1210.          renamed  back  by  MTA  to  ZIPCONV$.$$$  before the conversion
  1211.          starts. In general, when  you receive files from  others, don't
  1212.          use the option, otherwise you could set it.
  1213.  
  1214.  Relate: None
  1215.  Source: ARJ
  1216.  
  1217.  
  1218.  
  1219.  3.3.2 Statements that define the environment that MTA uses
  1220.  ───────────────────────────────────────────────────────────────────────
  1221.  The following statements  all define a  part of the  actual environment
  1222.  that MTA.EXE will use. Included are statements that define the  several
  1223.  directories that MTA can use,  the minimal requirements for memory  and
  1224.  space on the drives, the swapping functions and so on.
  1225.  
  1226.  ┌─────────────────────────────────────────────────────────────────────┐
  1227.  │ TempPath [dir] {bytfree}                                            │
  1228.  └─────────────────────────────────────────────────────────────────────┘
  1229.  Usage : Most decompressors  can   use an  assigned work-directory.   It
  1230.          can be useful  to point this  work-directory to a  virtual disk
  1231.          (a  so called RAM-disk)  or to  the fastest  medium you   have,
  1232.          but,  in  most   cases,   you   must   sure   that  this  drive
  1233.          (directory) will contain  enough space to  hold  the  temporary
  1234.          work  files  for   the  largest   file   to     convert.   Some
  1235.          archivers   also  use   the environment variable TEMP to   look
  1236.          which directory  can   be used  for temporary   work-space.  In
  1237.          MTA you  can (optionally) assign the temporary directory   that
  1238.          will be  passed  to all  archivers  that can work with  such  a
  1239.          directory. In  most cases,   this will  cause the   archiver to
  1240.          use THIS   directory for   work-space and NOT  the one supplied
  1241.          in   the  variable  TEMP  (if  any).   In  doubt,  consult  the
  1242.          documentation of the archiver in question.
  1243.  
  1244.          [dir]         This value must point to a valid  drive/directory
  1245.                        which can  be used  for temporary  work-space. If
  1246.                        no drive  is supplied,  the default  one is used.
  1247.                        Relative  directories  (..\WRKDIR  and  such) are
  1248.                        not  advised  but  can  be  used (the are counted
  1249.                        from the CURRENT directory).
  1250.  
  1251.          {bytfree}     For  most conversions you need at least  a number
  1252.                        of  bytes  free  on  the  assigned work-directory
  1253.                        (drive).  To  make  sure  that  this  amount   is
  1254.                        present  on  that  drive,  you  can,  optionally,
  1255.                        supply the number of  bytes that must be  free as
  1256.                        the third  parameter. If  the number  of bytes on
  1257.                        the drive is LOWER  than the supplied value,  MTA
  1258.                        will not work and abort with an error. If you  do
  1259.                        not supply  a value,  MTA will  look if  at least
  1260.                        256K bytes  is available,  though that  could not
  1261.                        be enough in  some cases. If  you want to  ignore
  1262.                        the test at all, you can supply a value if 0.
  1263.  
  1264.  Relate: None
  1265.  Dest. : All
  1266.  
  1267.  
  1268.  ┌─────────────────────────────────────────────────────────────────────┐
  1269.  │ MTATempPath [dir] {bytfree}                                         │
  1270.  └─────────────────────────────────────────────────────────────────────┘
  1271.  Usage : For every  archive (and  other object)  that MTA will  convert,
  1272.          MTA creates (and later on removes) a temporary directory  UNDER
  1273.          the current directory. If this  is not what you want  (and this
  1274.          is advised), you must supply this option.
  1275.  
  1276.          [dir]         This value must point to a valid  drive/directory
  1277.                        which can be  used for temporary  directories. If
  1278.                        no drive  is supplied,  the default  one is used.
  1279.                        Relative  directories  (..\WRKDIR  and  such) are
  1280.                        not  advised  but  can  be  used (the are counted
  1281.                        from the  CURRENT directory).  In fact,  relative
  1282.                        directories for this option, are useless in  most
  1283.                        cases.
  1284.  
  1285.          {bytfree}     For  most conversions you need at least  a number
  1286.                        of bytes free on the assigned directory  (drive).
  1287.                        To make sure that this amount is present on  that
  1288.                        drive, you can, optionally, supply the number  of
  1289.                        bytes that must be  free as the third  parameter.
  1290.                        If  the  number  of  bytes  on the drive is LOWER
  1291.                        than the  supplied value,  MTA will  not work and
  1292.                        abort  with  an  error.  If  you  do not supply a
  1293.                        value, MTA will  look if at  least 256K bytes  is
  1294.                        available,  though  that  could  not be enough in
  1295.                        some cases.  If you  want to  ignore the  test at
  1296.                        all, you can supply a value if 0.
  1297.  
  1298.          MTA  will  create  temporary  directories UNDER this directory.
  1299.          The name  is 8  bytes long  (and when  you run  as a  second or
  1300.          third TASK, not child,  they also contain the  task-number) and
  1301.          will  represent  the  HEX  value  of  the  time/date  they were
  1302.          created.  When running as  a child of itself (arc-in-arc),  MTA
  1303.          will create temporary directories  with the name '$'  under the
  1304.          original first (8 byte) temporary directory.
  1305.  
  1306.          Some archivers (DWC as the  most important, related to MTA)  do
  1307.          not like  to see  points inside  a directory-name.  Such a name
  1308.          (f.i. DC33ABAF.1) can ONLY be  the LAST tree from the  root. As
  1309.          an  example,  C:\ZIP\DC33ABAF.1  is   allright  with  DWC   but
  1310.          C:\ZIP.ZIP\DC33ABAF.1 is NOT.
  1311.  
  1312.  Relate: None
  1313.  Dest. : All
  1314.  
  1315.  
  1316.  ┌─────────────────────────────────────────────────────────────────────┐
  1317.  │ MTAErrorPath [dir]                                                  │
  1318.  └─────────────────────────────────────────────────────────────────────┘
  1319.  Usage : When  decompression   fails  (memory, corrupted archive and  so
  1320.          on), MTA will  put the original  archive (even though  it could
  1321.          not be OK)  into the temporary  directory that was  assigned to
  1322.          this file (the directory with  the 8-byte (or more) name  under
  1323.          the current directory  OR under the  directory assigned in  the
  1324.          MTATempPath  option   (see  above).   This  will   lead  to   a
  1325.          maintenance  problem  when  much  archives  fail. All corrupted
  1326.          files are moved to different directories and you need tools  to
  1327.          move  (or  delete)  them  all  AND  to  remove  the   temporary
  1328.          directories.  If  you  do  not  want  this maintenance, you can
  1329.          assign a  special directory  where MTA  places such  files. All
  1330.          you have to do, is to include this option in MTA.CTL.
  1331.  
  1332.          [dir]         This value must point to a valid  drive/directory
  1333.                        which  can  be  used  for  files  in error. If no
  1334.                        drive  is  supplied,  the  default  one  is used.
  1335.                        Relative  directories  (..\WRKDIR  and  such) are
  1336.                        not  advised  but  can  be  used (the are counted
  1337.                        from the  CURRENT directory).  In fact,  relative
  1338.                        directories for this option, are useless in  most
  1339.                        cases.
  1340.  
  1341.  Relate: None
  1342.  Dest. : All
  1343.  
  1344.  
  1345.  ┌─────────────────────────────────────────────────────────────────────┐
  1346.  │ FDUTempPath  [dir]                                                  │
  1347.  │ FDUTrashPath [dir]                                                  │
  1348.  └─────────────────────────────────────────────────────────────────────┘
  1349.  Usage : When you want to  convert whole diskettes to a new  system (use
  1350.          the /D switch,  see later), you  need two special  directories.
  1351.          Without these  directories you  can still  convert archives  on
  1352.          diskette but  you can't  use the  special options  that MTA can
  1353.          offer when  converting diskettes.  There is  a special  chapter
  1354.          about the conversion of diskettes.
  1355.  
  1356.          [dir]         This value must point to a valid  drive/directory
  1357.                        which can be used the  /D option. If no drive  is
  1358.                        supplied,  the  default  one  is  used.  Relative
  1359.                        directories (..\WRKDIR and such) are not  advised
  1360.                        but  can  be  used  (the  are  counted  from  the
  1361.                        CURRENT  directory).   The  directories  must NOT
  1362.                        point  to  the  same  drive  as  you are going to
  1363.                        convert. For a 'mixed' (HDU and FDU) system,  you
  1364.                        must  assign  the  HDU,  for  a  'single'  (FDU 2
  1365.                        times)  system,  you  must  assign a directory on
  1366.                        the other diskette station.
  1367.  
  1368.  Relate: /D option
  1369.  Dest. : All
  1370.  
  1371.  
  1372.  ┌─────────────────────────────────────────────────────────────────────┐
  1373.  │ ITSPath [dir]                                                       │
  1374.  └─────────────────────────────────────────────────────────────────────┘
  1375.  Usage : MTA can be used  in combination with ITS (version 1.06  and all
  1376.          higher versions). When  used in combination  with ITS, MTA  can
  1377.          be stopped like pressing the ESC-key but now without any  human
  1378.          actions involved.  The stopping  of MTA  is ruled  from the ITS
  1379.          task(s) that are running.
  1380.  
  1381.          [dir]         This value must point to a valid  drive/directory
  1382.                        which contains the ITS.SPH  file. If no drive  is
  1383.                        supplied,  the  default  one  is  used.  Relative
  1384.                        directories (..\WRKDIR and such) are not  advised
  1385.                        but  can  be  used  (the  are  counted  from  the
  1386.                        CURRENT directory).
  1387.  
  1388.          MTA MUST find the ITS.SPH file, otherwise MTA will abort,  even
  1389.          when ITS is not  currently in use. If  you don't have (or  use)
  1390.          ITS, you must leave this option OFF.
  1391.  
  1392.  Relate: None
  1393.  Dest. : All
  1394.  
  1395.  
  1396.  ┌─────────────────────────────────────────────────────────────────────┐
  1397.  │ SwapPath [dir]                                                      │
  1398.  └─────────────────────────────────────────────────────────────────────┘
  1399.  Usage : MTA can  (and will)  use a  mechanism to  clear memory when  it
  1400.          needs to. This technique  is called swapping. Swapping  will do
  1401.          the following:
  1402.  
  1403.          - All  data structures  that MTA  uses are  compressed together
  1404.            and written to the swapping device;
  1405.  
  1406.          - All program-coding minus a small piece (the program code  for
  1407.            the swapping itself) will be written to the swapping device;
  1408.  
  1409.          - Memory  is  cleared  an  will  be  rearranged  so it will  be
  1410.            (again) one continuous piece of memory;
  1411.  
  1412.          - The external  program (compressor, decompressor,  exit, virus
  1413.            checker and so on) is called and uses the freed memory;
  1414.  
  1415.          - After termination of the external program, control is  passed
  1416.            to the swapping-code that remained in memory;
  1417.  
  1418.          - The  coding will  (again) rearrange  memory as  it was,  will
  1419.            read   the   program-coding   back   AND   will   read    all
  1420.            data-structures back;
  1421.  
  1422.          - It will clean the swapping device;
  1423.  
  1424.          - It will pass control back to the point where MTA was;
  1425.  
  1426.          With  this  technique,  around  230.000  bytes are removed from
  1427.          memory. These 230.000  were in use  by MTA (non-overlayed)  and
  1428.          there  will  remain  only  a  couple  of bytes for the swapping
  1429.          itself (around 4K bytes).
  1430.  
  1431.          Normally  the  swapping  device  can  be  any  of the following
  1432.          resources:
  1433.  
  1434.          - EMS
  1435.            First   choice,   unless   the   NoEMS   option   (or  /NOEMS
  1436.            command-line parameter)  is supplied  or there  is not enough
  1437.            EMS to contain all data (ca. 230.000 bytes);
  1438.  
  1439.          - XMS
  1440.            Second choice  in SOME  cases. Not  all swapping  routines in
  1441.            MTA  can   support  XMS   yet.  If   the  NoXMS   (or  /NOXMS
  1442.            command-line parameter)  is supplied  or there  is not enough
  1443.            (or no)  XMS to  contain all  data (ca.  230.000 bytes),  MTA
  1444.            will use the next resource;
  1445.  
  1446.          - Disk
  1447.            When there is  not enough (or  no) EMS or  XMS (or the  NoEms
  1448.            and/or NoXMS options are active),  MTA will use disk for  the
  1449.            swapping;
  1450.  
  1451.          When  MTA  is  forced  to  use  disk,  it  will use the current
  1452.          directory for the swap-file that will be created. You can  (and
  1453.          sometimes MUST) overrule this with this option.
  1454.  
  1455.          [dir]         This value must point to a valid  drive/directory
  1456.                        which contains the swapping file. If no drive  is
  1457.                        supplied,  the  default  one  is  used.  Relative
  1458.                        directories (..\WRKDIR and such) are not  advised
  1459.                        but  can  be  used  (the  are  counted  from  the
  1460.                        CURRENT directory).
  1461.  
  1462.          You can also assign a directory  on a RAM-disk when you have  a
  1463.          large one. The only place where MTA disallows disk-swapping  is
  1464.          on  REMOVABLE  drives  (diskettes).  The swap-file (if created)
  1465.          has a  special (unique)  name and  will have  the HIDDEN/SYSTEM
  1466.          attribute. You must NEVER try  to remove such a file  while MTA
  1467.          is still running. It will cause a hangup !
  1468.  
  1469.  Relate: All swapping options
  1470.  Dest. : All
  1471.  
  1472.  
  1473.  ┌─────────────────────────────────────────────────────────────────────┐
  1474.  │ NoEMS                                                               │
  1475.  │ NoXMS                                                               │
  1476.  └─────────────────────────────────────────────────────────────────────┘
  1477.  Usage : When you do not want MTA to use either (or both) EMS or (and)
  1478.          XMS, you can add these option(s) to MTA.CTL. When NoEMS is set
  1479.          and NoXMS isn't and you use QEMM or 386Max (or some program
  1480.          like that), XMS is used. When you set both options, only disk
  1481.          is used. These options are related to the swapping mechanism.
  1482.          This mechanism is the only mechanism in MTA that can make use
  1483.          of EMS/XMS.
  1484.  
  1485.  Relate: All swapping options
  1486.  Dest. : All
  1487.  
  1488.  
  1489.  ┌─────────────────────────────────────────────────────────────────────┐
  1490.  │ MoveToDir [dir]                                                     │
  1491.  └─────────────────────────────────────────────────────────────────────┘
  1492.  Usage :  MTA can,  optionally, move  archives (and  all other converted
  1493.          objects) to another directory  AFTER the conversion. There  are
  1494.          currently 2 different  ways to obtain  this result. One  is the
  1495.          usage of the DefaultPath option (see later), which can be  used
  1496.          by most SysOp's of Bulletin Boards. The other one, the  current
  1497.          option, can be used when  you want to move all  converted files
  1498.          from any directory that you wish to use to a new one.  Normally
  1499.          you will use the  command-line /M to do  so, but if you  always
  1500.          want to have the converted archives on the same place, you  can
  1501.          use the MoveToDir option.
  1502.  
  1503.          [dir]         This value must point to a valid  drive/directory
  1504.                        where  the  files  are  moved  to. If no drive is
  1505.                        supplied,  the  default  one  is  used.  Relative
  1506.                        directories (..\WRKDIR and such) are not  advised
  1507.                        but  can  be  used  (the  are  counted  from  the
  1508.                        CURRENT directory).
  1509.  
  1510.          There  is  one  special  format.  When  combining the /D option
  1511.          (diskette conversion)  with the  MoveToDir (or  the /M command-
  1512.          line parameter), MTA will  convert diskettes from one  diskette
  1513.          to another  one. If  you mix  runs of  MTA to convert diskettes
  1514.          AND to  do normal  conversion, you  can get  problems when this
  1515.          option is put into the MTA.CTL. In such cases it is advised  to
  1516.          use the /M command-line parameter.
  1517.  
  1518.          WARNING: When  you  use  MoveToDir  in  conjunction  with   the
  1519.                   ExitAfterCompression option  you have  to be  aware of
  1520.                   the following extra's:
  1521.  
  1522.                   - When you create an  extra file in the exit  with the
  1523.                     extension  .COM  or  .EXE  which  is  in  the   same
  1524.                     directory   as   the   original   compressed   file,
  1525.                     MoveToDir moves these files also.  When a  name-like
  1526.                     file  already   exist  in   the  MoveToDir    target
  1527.                     directory, MTA  gives you  a warning  and leaves the
  1528.                     file  where  it  was.  This  does  not  go  for  the
  1529.                     original compressed file;
  1530.  
  1531.                   - When  you delete  the original  compression file  in
  1532.                     the  exit,  MTA  will  notice  this and will take no
  1533.                     further actions;
  1534.  
  1535.          When you are running 4Dos <tm> and your original files  contain
  1536.          a  description  in  the  4Dos  description  file,  MTA will use
  1537.          4DOS's MOVE command  to move any  files (if MTA  has detected a
  1538.          full 4DOS environment and the Not4DosAware option is not  set).
  1539.          This  will  cause  any  descriptions  (added  with  4DOS) to be
  1540.          carried along to the new directory.
  1541.  
  1542.  Relate: Not4DosAware, /D command-line parameter
  1543.  Dest. : All
  1544.  
  1545.  
  1546.  ┌─────────────────────────────────────────────────────────────────────┐
  1547.  │ FreeMemory [minfree]                                                │
  1548.  └─────────────────────────────────────────────────────────────────────┘
  1549.  Usage : MTA  uses  memory   very  dynamically.  When  you   convert two
  1550.          different directories you will see that the starting amount  of
  1551.          free memory (displayed by MTA) will never be the same. To  make
  1552.          the  story  short,  almost  every  option  that  can be entered
  1553.          multiple  times  (like  DoNot,  DefaultPath, IncludeFile and so
  1554.          on) will take a  few extra bytes of  memory and all files  that
  1555.          will be  converted (up  to 1000  in one  run) will  also take a
  1556.          dynamic amount of memory. All external calls can be ruled  with
  1557.          a  swap  option  (see  xxxPath,  Virusscanner and all exits) so
  1558.          that is not such  a problem. Also MTA  will take a look  at the
  1559.          memory and  will determine  if it  is possible  to make  itself
  1560.          useful in the presented amount  of bytes. If you still  want to
  1561.          abort  MTA  when  a  specific  number  of  free  bytes  in  NOT
  1562.          available, you can add this option to MTA.CTL.
  1563.  
  1564.          [minfree]     This value must be the number of BYTES (not  KILO
  1565.                        bytes)  that  must  be  free  in order to let MTA
  1566.                        start the conversion.
  1567.  
  1568.          By default MTA will look if  256Kb is free in memory after  all
  1569.          structures are build in memory. You can overrule the test  when
  1570.          you supply 'FreeMemory 0'.
  1571.  
  1572.  Relate: None
  1573.  Dest. : All
  1574.  
  1575.  
  1576.  ┌─────────────────────────────────────────────────────────────────────┐
  1577.  │ Runtime [seconds]                                                   │
  1578.  └─────────────────────────────────────────────────────────────────────┘
  1579.  Usage : MTA can be  interrupted when running attended (by  pressing the
  1580.          ESC key)  but when  you run  UNattended this  can be a problem.
  1581.          When you want to  run MTA for a  certain time (when MTA  is run
  1582.          inside a BBS event for instance), you can supply this option.
  1583.  
  1584.          [seconds]     This value  must be set to the number of  seconds
  1585.                        that MTA must execute.
  1586.  
  1587.          If the time is  over and there are  still files left, MTA  will
  1588.          skip them. To  make sure that  already converted files  are not
  1589.          converted again, it is advised  to either move them to  another
  1590.          directory, use MTA's marking-technique or use the option  where
  1591.          MTA will only convert files that have an earlier date then  the
  1592.          file FILES.MTA (a semaphore file, see later).
  1593.  
  1594.          MTA will always  run somewhat longer  than [seconds]. MTA  will
  1595.          not stop in the middle of a conversion so the one that  started
  1596.          [seconds]-1 will be finished. If  this is a big one,  some time
  1597.          can pass before MTA will terminate.
  1598.  
  1599.  Relate: None
  1600.  Dest. : All
  1601.  
  1602.  
  1603.  ┌─────────────────────────────────────────────────────────────────────┐
  1604.  │ Not4DosAware                                                        │
  1605.  └─────────────────────────────────────────────────────────────────────┘
  1606.  Usage : MTA will do some  internal DOS-calls to see if 4DOS  is present
  1607.          in the machine. If so, MTA will use 4DOS's move on any move  of
  1608.          a file that  will be done  inside MTA. If  there is no  4DOS in
  1609.          usage,  MTA  will  use  its  own  internal  (and quicker) MOVE.
  1610.          4DOS's MOVE is  used to move  any descriptions inside  the file
  1611.          DESCRIPT.ION (a 4DOS internal file which can be present  inside
  1612.          the directory with a HIDDEN attribute).
  1613.  
  1614.          If you don't  use 4DOS descriptions  for your files  and/or you
  1615.          want to use the faster internal  MOVE AND you run 4DOS on  your
  1616.          machine, you can include this option.
  1617.  
  1618.  Relate: MoveToPath (and all internal moves)
  1619.  Dest. : All
  1620.  
  1621.  
  1622.  ┌─────────────────────────────────────────────────────────────────────┐
  1623.  │ VideoMode [mode]                                                    │
  1624.  └─────────────────────────────────────────────────────────────────────┘
  1625.  Usage : MTA can adjust  itself to non-standard text-modes. Some  of the
  1626.          more common examples are 80x43, 132x60 and so on. If you  enter
  1627.          MTA  when  the  screen  is  such  a  mode,  MTA will extend the
  1628.          display in  the actual  number of  lines and,  with modes  that
  1629.          support  more  than   110  characters,  also   the  number   of
  1630.          characters on a line.
  1631.  
  1632.          If you  normally run  in a  normal text-mode  (80x25) but still
  1633.          want to  see MTA  running in  a special  text-mode, you can add
  1634.          this statement to MTA.CTL.
  1635.  
  1636.          [mode]        This  is the  decimal number of  the video   mode
  1637.                        that  MTA  will  try  to  set.  Look  inside your
  1638.                        video-card manual  to see  which mode  you should
  1639.                        use.
  1640.  
  1641.          After MTA  has processed  the MTA.CTL  options, MTA  will reset
  1642.          the video-card to  the supplied mode  (if included in  MTA.CTL)
  1643.          and before termination,  MTA will reset  to the standard  text-
  1644.          mode. If you use an invalid mode, damage to your monitor  could
  1645.          be the case (see video-card manual) or you are not able to  see
  1646.          anything  until  MTA  has  finished  (or  the  machine can even
  1647.          hang).
  1648.  
  1649.  Relate: None
  1650.  Dest. : All
  1651.  
  1652.  
  1653.  ┌─────────────────────────────────────────────────────────────────────┐
  1654.  │ SubstDrive [drivearray]                                             │
  1655.  └─────────────────────────────────────────────────────────────────────┘
  1656.  Usage : This is a VERY  important option. Most archives include the  so
  1657.          called directory entries. These  are the directories that  were
  1658.          included when the archive was created. If an archive was  made,
  1659.          containing all files (*.*)  from the current directory  and all
  1660.          lower trees AND you supplied the options to include the  actual
  1661.          directories,  given  the  following  structure  (root  is   the
  1662.          current directory):
  1663.  
  1664.          [root, current directory, drive C]
  1665.             CONFIG.SYS
  1666.             [sub-dir HLP]
  1667.             TEST.TST
  1668.                 [sub-dir ZIP]
  1669.                 TEST.TST
  1670.                 [sub-dir ZAP]
  1671.                 TEST.TST
  1672.                    [sub-dir ZA1]
  1673.                    TEST.TST
  1674.                    [sub-dir ZA2]
  1675.                    TEST.TST
  1676.  
  1677.          the  archive  will  contain  one  of the two following formats,
  1678.          either the relative directories:
  1679.  
  1680.          CONFIG.SYS
  1681.          HLP\TEST.TST
  1682.          HLP\ZIP\TEST.TST
  1683.          HLP\ZAP\TEST.TST
  1684.          HLP\ZAP\ZA1\TEST.TST
  1685.          HLP\ZAP\ZA2\TEST.TST
  1686.  
  1687.          or the absolute directories:
  1688.  
  1689.          \CONFIG.SYS
  1690.          \HLP\TEST.TST
  1691.          \HLP\ZIP\TEST.TST
  1692.          \HLP\ZAP\TEST.TST
  1693.          \HLP\ZAP\ZA1\TEST.TST
  1694.          \HLP\ZAP\ZA2\TEST.TST
  1695.  
  1696.          The fact  if there  are ABSOLUTE  or RELATIVE  directories will
  1697.          depend on  the type  of archive  system. Normally  (without the
  1698.          SubstDrive option  set), MTA  will only  convert directories if
  1699.          the  source  archive  system  contains RELATIVE directories AND
  1700.          the target archive system  can contain directory entries.   For
  1701.          some  archivers  you  can  not  be  sure about the fact if they
  1702.          contain ABSOLUTE  or RELATIVE  directories and  some will  ONLY
  1703.          contain  ABSOLUTE  entries.  When  MTA  would  convert  such an
  1704.          archive, it would extract the  archive with all options into  a
  1705.          directory  F:\JUST\AN\EXAMPLE\156DA12F  (just  an  example) but
  1706.          while  decompress  starts,  the  decompress  program  would add
  1707.          files in ABSOLUTE directories, causing NONE of the files to  be
  1708.          added to F:\JUST\AN\EXAMPLE\156DA12F. Files would be stored  in
  1709.          C:\,  C:\HLP\,  C:\HLP\ZIP,  C:\HLP\ZAP,  C:\HLP\ZA1  and   the
  1710.          C:\HLP\ZA2 directory.
  1711.  
  1712.          MTA would be  able to notice  this and could  archive the files
  1713.          from  these  directories  back  into  the new archive (with the
  1714.          delete option) but  there are too  many risks involved.  MTA is
  1715.          created so  UNATTENDED operation  is possible.  To secure this,
  1716.          all warnings  and queries  are suppressed.  MTA would  start to
  1717.          call  the  decompress  program  and  the  first thing that will
  1718.          happen is the overwrite of  CONFIG.SYS on C:\ (all other  files
  1719.          look like if they will  not cause any trouble). When  MTA would
  1720.          start the target-compression program, CONFIG.SYS would then  be
  1721.          archived AND  deleted, leaving  C: without  CONFIG.SYS. Can you
  1722.          imagine what would  happen if files  like IO.SYS and  MSDOS.SYS
  1723.          would be extracted to the root or COMMAND.COM ?
  1724.  
  1725.          Given the  example above,  MTA will  NEVER decompress  archives
  1726.          that could  contain ABSOLUTE  directories unless  you use  some
  1727.          special options. There ARE many archives that have a  structure
  1728.          like this AND you  would still be able  to convert them but  in
  1729.          all cases WITHOUT any risk involved.
  1730.  
  1731.          For this reason, MTA  contains support for SUBSTituted  drives.
  1732.          If you don't know what  the command SUBST means under  DOS, you
  1733.          should read the DOS manual.  In short, SUBST will create  a new
  1734.          drive-letter and the root of  this drive is the same  directory
  1735.          as you supply  to SUBST. So  when you make  a SUBST drive  (G:)
  1736.          from F:\JUST\AN\EXAMPLE\156DA12F (see above), G:\ would be  the
  1737.          same  as   F:\JUST\AN\EXAMPLE\156DA12F  and   all   directories
  1738.          created under G:\ would in fact be created under the  directory
  1739.          F:\JUST\AN\EXAMPLE\156DA12F.  With  this  trick  (which  is   a
  1740.          normal DOS command), you CAN convert archives with  directories
  1741.          that  are  ABSOLUTE  and  you  can  still convert archives with
  1742.          RELATIVE  directories.  If  you  include the SubstDrive option,
  1743.          all  archives  WITH  directories,  no  matter  the  type of the
  1744.          directories, will convert in the  BEST possible way to the  new
  1745.          target (if  the new  target does  not support  directories, MTA
  1746.          can't fix that, but if it does, they will be there).
  1747.  
  1748.          There are some precautions to  take before you start with  this
  1749.          option. First, your DOS must support SUBSTituted drives:
  1750.  
  1751.          - Your DOS  must support SUBSTituted  drives. All DOS  versions
  1752.            from  3.0  and  up  will  contain the support for SUBSTituted
  1753.            drives;
  1754.  
  1755.          - You need the DOS program that can make and delete these  kind
  1756.            of SUBSTituted drives. This  program is called SUBST  (EXE in
  1757.            most cases, sometimes COM).   It would be possible to  have a
  1758.            self-contained  support  in  MTA  but  the  methods to create
  1759.            SUBSTituted drives  vary every  DOS release.  Make sure  that
  1760.            the program  SUBST.EXE or  SUBST.COM is  somewhere inside the
  1761.            DOS-path (MTA will search for the file itself and will  abort
  1762.            if  the  SubstDrive  option  is  set  but  the  SUBST.EXE/COM
  1763.            program isn't found);
  1764.  
  1765.          - You  must alter  the LASTDRIVE  option in  CONFIG.SYS (or set
  1766.            with one of  the QEMM <tm>  utilities) to a  higher value. If
  1767.            your current last drive is F:  and you are going to run  only
  1768.            ONE MTA at a time (it  is possible to run multiple copies  at
  1769.            the same time  under any multi-tasker  like DesqView <tm>  or
  1770.            MS Windows <tm>), you can set it to G:. In fact, you need  as
  1771.            much extra drives as  the number of concurrently  running MTA
  1772.            programs.  If  you  have   a  variable  drive   configuration
  1773.            (sometimes you have a  RAM-disk, sometimes you haven't),  you
  1774.            can also assign a much higher letter. In fact, it is  allowed
  1775.            to use drive Z: for SUBSTituted drives, even if the last  one
  1776.            is F:. In doubt, you  must leave out the LASTDRIVE  option in
  1777.            CONFIG.SYS;
  1778.  
  1779.          - You  must test  the SUBST  program manually  to make  sure is
  1780.            works. Use a directory and  try SUBST on all drives  that are
  1781.            going to use in MTA;
  1782.  
  1783.          If all  points above  are checked,  you can  add the SubstDrive
  1784.          option in MTA.  If you use  the SubstDrive option  with invalid
  1785.          letters things  CAN go  wrong. I  strongly advise  to use drive
  1786.          letters that are NEVER  going to be used  (f.i. Y: and Z:  when
  1787.          running 2  concurrent MTA's  or only  Z: if  you only use one).
  1788.          It IS  possible but  NEVER use  a drive  letter that  is one of
  1789.          your CURRENT drives and certainly  not one of the floppy  drive
  1790.          letters if you want to use the /D option !
  1791.  
  1792.          [drivearray]   You must  supply at  least one  drive-letter but
  1793.                        you  can  supply  op  to  26.  You  must supply a
  1794.                        different  letter  for  each  concurrent MTA that
  1795.                        you  are  going  to  run.  The first MTA (task 1)
  1796.                        uses  the  first  letter,  the  next MTA (task 2)
  1797.                        will  use  the  second  and  so  on  !  With  all
  1798.                        warnings  in  mind,  you  could supply the option
  1799.                        'SubstDrive  Z'  of  one  MTA and 'SubstDrive YZ'
  1800.                        for two concurrently running MTA's;
  1801.  
  1802.          There is  nothing to  worry about  when you  use the SubstDrive
  1803.          option  (unless  you  have  a  very special configuration). MTA
  1804.          will do all the work  for you. MTA will assign  the SUBSTituted
  1805.          drives itself (by calling  SUBST.EXE/COM) and will remove  them
  1806.          again when  conversion is  finished. MTA  will check  the drive
  1807.          letters you supplied  in the SubstDrive  to see if  any of them
  1808.          is a 'real' drive. If this  is the case, MTA will abort.  Under
  1809.          special conditions  this test  may fail  though, so  you should
  1810.          take  all  previous  warnings  in  mind before you start. Don't
  1811.          experiment  with  the  option,  just  do  it  the  way  it   is
  1812.          suggested.
  1813.  
  1814. │Relate: SubstOn, SubstOff
  1815.  Dest. : All
  1816.  
  1817.  
  1818. │┌─────────────────────────────────────────────────────────────────────┐
  1819. ││ SubstOn [path] {parm}..{parm}                                       │
  1820. │└─────────────────────────────────────────────────────────────────────┘
  1821. │Usage : This  option  can  only   be  used  in  combination  with   the
  1822. │        SUBSTDrive  option.   When  used,   the  SubstOff   option   is
  1823. │        mandatory.
  1824. │
  1825. │        When SubstDrive  is set,  MTA will  use the  following calls to
  1826. │        the DOS SUBST.EXE  program to set  the substituted drive  ON or
  1827. │        OFF:
  1828. │
  1829. │        - On
  1830. │          [drive:][dir]\SUBST.EXE [drive_to_page] [dir_to_page_over]
  1831. │
  1832. │        - Off
  1833. │          [drive:][dir]\SUBST.EXE [drive_to_page] /D
  1834. │
  1835. │        Normally  this  will  work  in  the  proper way unless you need
  1836. │        another syntax (special DOS-versions) or you even need  another
  1837. │        program (networks) to  page (virtual) drives  over directories.
  1838. │        For this need,  you can use  the SubstOn and  SubstOff options.
  1839. │        With  these  options,  you  can  tell MTA which program(s) with
  1840. │        which parameters  are to  be called  to switch  the substituded
  1841. │        (paged) drive on (SubstOn) and off (SubstOff):
  1842. │
  1843. │        [Path]        This parameter must contain the drive,  directory
  1844. │                      and  filename  of  the  program  in question. MTA
  1845. │                      will  validate  the working of the program;
  1846. │
  1847. │        [parm] {parm} At  this  location   you  can  (must) supply  the
  1848. │                      various parameters for  the program. There  are a
  1849. │                      few macros  available  that  will  be replaced by
  1850. │                      values at run-time. These are:
  1851. │
  1852. │                      %DP This  macro will  be replaced  with the drive
  1853. │                          letter (without  ':') of  drive that  will be
  1854. │                          paged over the temporary directory;
  1855. │
  1856. │                      %DF This  macro will  be replaced  with the drive
  1857. │                          letter  (WITH  ':')  of  drive  that  will be
  1858. │                          paged over the temporary directory;
  1859. │
  1860. │                      %PP This macro will be replaced by the  temporary
  1861. │                          directory  that  needs  to  be  accessed as a
  1862. │                          drive  (normally  a  directory  under the one
  1863. │                          you  specified  in  MTATempPath).  This macro
  1864. │                          will NOT give a directory with a backslash;
  1865. │
  1866. │                      %PF This macro will be replaced by the  temporary
  1867. │                          directory  that  needs  to  be  accessed as a
  1868. │                          drive  (normally  a  directory  under the one
  1869. │                          you  specified  in  MTATempPath).  This macro
  1870. │                          WILL give a directory with a backslash;
  1871. │
  1872. │        Included are  two examples,  one that  will be  the same as MTA
  1873. │        uses internally (but now  specified with SubstOn and  SubstOff)
  1874. │        and one  for a  network that  needs a  program MAP to subtitute
  1875. │        (page the drive).  The first example  is split in  two examples
  1876. │        (one with  a DIRECT  call to  SUBST and  one using a batch-file
  1877. │        SUBST.BAT):
  1878. │
  1879. │        - Using SUBST (THIS IS THE MTA DEFAULT AND NEED NOT BE USED)
  1880. │          - Directly:
  1881. │            SubstOn  C:\DOS\SUBST.EXE %DF %PP
  1882. │            SubstOff C:\DOS\SUBST.EXE %DF /D
  1883. │          - Called from a batch-file
  1884. │            SubstOn  C:\DOS\COMMAND.COM /C C:\DOS\SUB.BAT %DF %PP
  1885. │            SubstOff C:\DOS\COMMAND.COM /C C:\DOS\SUB.BAT %DF /D
  1886. │
  1887. │        - Using MAP (only an example, use your own Network-program)
  1888. │          SubstOn  C:\NOV\MAP.EXE   %DF=%PP
  1889. │          SubstOff C:\NOV\MAP.EXE R %DF
  1890. │
  1891. │Relate: SubstOff
  1892. │Dest. : All
  1893. │
  1894. │
  1895. │┌─────────────────────────────────────────────────────────────────────┐
  1896. ││ SubstOff [path] {parm}..{parm}                                      │
  1897. │└─────────────────────────────────────────────────────────────────────┘
  1898. │Usage : See SubstOn (SubstOff is used tro switch the substitution off).
  1899. │
  1900. │Relate: SubstOn
  1901. │Dest. : All
  1902.  
  1903.  
  1904.  ┌─────────────────────────────────────────────────────────────────────┐
  1905.  │ ExtendedTesting                                                     │
  1906.  └─────────────────────────────────────────────────────────────────────┘
  1907.  Usage : Some older  decompress programs  do not  return an  errorlevel
  1908.          when something is wrong with the decompress. For example,  some
  1909.          older PAK versions (GSARC) could signal that one or more  files
  1910.          inside the archive  contained a CRC-error  but returned a  zero
  1911.          errorlevel. In these cases  MTA will think that  the decompress
  1912.          is ok, will remove the archive and will compress the  remaining
  1913.          (if any) files to a new archive, causing only a part (or  none)
  1914.          of the original archive to be converted.
  1915.  
  1916.          MTA can make  sure (for 98%)  that the extracted  files are the
  1917.          same as the  ones that are  in the original  source-archive. To
  1918.          add this fail-save mechanism, you must add the  ExtendedTesting
  1919.          option in  MTA.CTL. MTA  will count  the combined  uncompressed
  1920.          bytes that the  archive will show  to the world  and will count
  1921.          these bytes again (bases on  the actual files) after the  files
  1922.          are decompressed. If they  differ, MTA will delete  these files
  1923.          again and will move the original archive to the directory  that
  1924.          contains the  faulty archives.  A warning  is produced  and the
  1925.          next conversion (if any) will start.
  1926.  
  1927.          There are some special archives that can not be tested for  the
  1928.          full 100%. These are:
  1929.  
  1930.          - ARJ  archives with  files that  are compressed  as TEXT-files
  1931.            ARJ can compress  files as TEXT-files  (-t1 parameter on  the
  1932.            ARJ  command-line).  The  filesize  of  such files inside the
  1933.            ARJ-archive  is  showed  as  the  size  WITHOUT any CR/LF and
  1934.            CTRL-Z  (EOF)  markers.  For  instance,  a  text-file  with 2
  1935.            records, each containing 10 bytes, will normally have a  size
  1936.            of (2 x 10) + (2 x 2  (CRLF)) + 1 is 25 bytes. ARJ will  show
  1937.            this file as a file with a size of 20. THIS IS ONLY THE  CASE
  1938.            with files that are compressed with -t1 !  If MTA detects  an
  1939.            ARJ-file  with  such  text-files  inside,  it  will  skip the
  1940.            extended  test  (not  to  worry,  because  ARJ will return an
  1941.            errorlevel when  the files  inside the  original archive  are
  1942.            not OK). In a  discussion with the author  of ARJ I was  told
  1943.            that  this  has  something  to  do  with  the multi- platform
  1944.            (DOS/UNIX and so on) support;
  1945.  
  1946.          - ARJ  and ZOO  archives with  backups inside  Both ZOO and ARJ
  1947.            archives  can  contain  backup  copies,  even multiple backup
  1948.            copies. When you make an archive with the file A.A inside  an
  1949.            a  few  days  later  you  will  do  this  again (with special
  1950.            ZOO/ARJ command-line options), the  first A.A will be  marked
  1951.            as backup  and the  second is  added. This  can go  on for  a
  1952.            large number of times, eventually resulting in archives  that
  1953.            contain (for  instance) 100  A.A files,  1 of  them being the
  1954.            original (the one  added last) and  99 backups.   There is NO
  1955.            direct  support  archival  backups  in  MTA  but  you CAN add
  1956.            options in MTA  to instruct ARJ  (and ZOO) to  extract all of
  1957.            these backups  (with a  rename, done  by the  archive program
  1958.            itself). Because  this is  possible, MTA  will skip  extended
  1959.            testing  for  archives  with  backups  inside.  This  is   no
  1960.            problem. ARJ and  ZOO will both  report errorlevels when  the
  1961.            decompress fails;
  1962.  
  1963.          It is advised to always use ExtendedTesting. The only  drawback
  1964.          is some loss in speed but on hard-disks this will be less  than
  1965.          a second for each file (average).
  1966.  
  1967.  Relate: None
  1968.  Dest. : All
  1969.  
  1970.  
  1971.  ┌─────────────────────────────────────────────────────────────────────┐
  1972.  │ ShareWait [seconds]                                                 │
  1973.  └─────────────────────────────────────────────────────────────────────┘
  1974.  Usage : You can  run multiple copies of  MTA AND it is  possible to run
  1975.          MTA in a second task (along side a BBS). In these cases it  can
  1976.          be possible  that MTA  needs resources  (files) that  the other
  1977.          task  is  using  also.  In  multi-tasking environments you must
  1978.          always load SHARE (see DOS manual) to give support to  programs
  1979.          that would  like to  share resources  (files). If  MTA needs  a
  1980.          resource  that  is  currently  locked  (a  file  that  is being
  1981.          updated by the other task), it will wait until the resource  is
  1982.          free again unless it  takes to long. If  it takes to long,  MTA
  1983.          will abort.
  1984.  
  1985.          MTA will look every 10 seconds to see if a resource if free  to
  1986.          use again  (after the  initial lock).  This process  will go on
  1987.          for 300  seconds (5  minutes) by  default. After  that, no  new
  1988.          cycle will  start, but  MTA will  abort. You  can also stop the
  1989.          cycle by pressing CTRL-E, in which case MTA will abort.
  1990.  
  1991.          [seconds]     By default, MTA will  look every 10 seconds   for
  1992.                        the duration of 300  seconds. You can alter  this
  1993.                        value  to  anything  you  like.  If  you  want to
  1994.                        change it, you  must supply the  ShareWait option
  1995.                        with  that  number  of  seconds. F.i., 'ShareWait
  1996.                        600' will cause MTA to look every 10 seconds  for
  1997.                        the duration of 600 seconds (is 10 minutes).
  1998.  
  1999.          ShareWait is ONLY needed in a multitasking/network  environment
  2000.          and has no meaning  when SHARE is not  loaded. If SHARE is  not
  2001.          loaded and a lock  occurs (multi-tasking without sharing),  MTA
  2002.          will abort directly !
  2003.  
  2004.  Relate: None
  2005.  Dest. : All
  2006.  
  2007.  
  2008.  ┌─────────────────────────────────────────────────────────────────────┐
  2009.  │ AltDisplay                                                          │
  2010.  └─────────────────────────────────────────────────────────────────────┘
  2011.  Usage : When running  in a  normal 80x25  text-screen, MTA can  display
  2012.          two different kind of information windows on the right side  of
  2013.          the  screen.  The  normal  one  contains  a summary of the most
  2014.          important options.  The other  one contains  a dynamic  list of
  2015.          the archives  that still  need to  be converted.  You can  swap
  2016.          between the list with  the 'T' key but  you can also force  MTA
  2017.          to display the dynamic file-list  at startup. In that case  you
  2018.          can  still  swap  screens  with  the  'T'  key, but the dynamic
  2019.          window is the first one to show up when you start MTA.
  2020.  
  2021.          To force  MTA to  start with  the dynamic  file-list, you  must
  2022.          supply the AltDisplay option.  When running in 110+x25+  modes,
  2023.          MTA will always display BOTH windows and the AltDisplay  option
  2024.          will be ignored.
  2025.  
  2026.  Relate: None
  2027.  Dest. : All
  2028.  
  2029.  
  2030.  ┌─────────────────────────────────────────────────────────────────────┐
  2031.  │ WarningTime [cycles]                                             (*)│
  2032.  └─────────────────────────────────────────────────────────────────────┘
  2033.  Usage : MTA will sometimes give a  warning or an error. In this case  a
  2034.          message is displayed and a  'running light' is displayed for  a
  2035.          number of  cycles. You  can stop  the cycles  by hitting ESC or
  2036.          you can wait until it is finished (around 20 seconds).
  2037.  
  2038.          [cycles]      By default, MTA  will use 20 cycles   (equivalent
  2039.                        to 20 seconds). You  can supply any value  from 0
  2040.                        (no cycles) to 65535.
  2041.  
  2042.          If you supply a value of  zero, MTA will also stop making  some
  2043.          noise when errors or warnings are displayed. If you supply  any
  2044.          non-zero value,  MTA will  beep when  an error  or a warning is
  2045.          displayed unless the NoBeep option is active.
  2046.  
  2047.  Relate: NoBeep
  2048.  Dest. : All
  2049.  (*)   : Marked options are also in usage by: MTM
  2050.  
  2051.  
  2052.  ┌─────────────────────────────────────────────────────────────────────┐
  2053.  │ NoBeep                                                              │
  2054.  └─────────────────────────────────────────────────────────────────────┘
  2055.  Usage : By default  MTA will produce a  beep on the PC-speaker  when an
  2056.          error or warning is displayed (or when MTA is finished).  There
  2057.          will be no  sound when WarningTIme  equals a value  of zero but
  2058.          in this case you  will also not see  any messages. If you  want
  2059.          to see  messages but  you dislike  the sound,  you must use the
  2060.          NoBeep option in MTA.CTL.
  2061.  
  2062.  Relate: WarningTime
  2063.  Dest. : All
  2064.  
  2065.  
  2066.  
  2067.  3.3.3 Statements that define the logging
  2068.  ───────────────────────────────────────────────────────────────────────
  2069.  MTA can log almost anything.  The following statements define the  type
  2070.  of logging (if any)  for the several actions  and the actual format  of
  2071.  the logged records.
  2072.  
  2073.  ┌─────────────────────────────────────────────────────────────────────┐
  2074.  │ LogPath [dir]                                                       │
  2075.  │ LogPath [path]                                                      │
  2076.  └─────────────────────────────────────────────────────────────────────┘
  2077.  Usage : MTA can log almost everything. Under normal conditions you  can
  2078.          choose not to log (it will  speed things up a little) but  then
  2079.          you will not be able to create statistical reports and  nothing
  2080.          can be traced back. In a BBS environment you can choose to  log
  2081.          in  the  same  log-file  as  the  one  that is used by your BBS
  2082.          program. In all cases  MTA will try to  open the log in  shared
  2083.          append mode, so current logs will appended to and full  sharing
  2084.          is available. There  are two different  ways you can  setup the
  2085.          logging:
  2086.  
  2087.          [dir]         This value must point to a valid  drive/directory
  2088.                        where logging  will take  place. If  no drive  is
  2089.                        supplied,  the  default  one  is  used.  Relative
  2090.                        directories (..\WRKDIR and such) are not  advised
  2091.                        but  can  be  used  (the  are  counted  from  the
  2092.                        CURRENT directory).   In this  case MTA  will try
  2093.                        to open the file  with the name MTA.LOG  and will
  2094.                        append  to  it  when  it  is present or create it
  2095.                        when it is not (yet) available;
  2096.  
  2097.          [path]        This value must point to a valid  drive/directory
  2098.                        and  filename  of  the  log-file.  If no drive is
  2099.                        supplied,  the  default  one  is  used.  Relative
  2100.                        directories (..\WRKDIR and such) are not  advised
  2101.                        but  can  be  used  (the  are  counted  from  the
  2102.                        CURRENT directory).   In this  case MTA  will try
  2103.                        to open the file with the SUPPLIED name and  will
  2104.                        append  to  it  when  it  is present or create it
  2105.                        when it is not (yet) available;
  2106.  
  2107.          The LogPath option only assigns the actual log-file or (if  not
  2108.          present) will force to 'noLog'. The style of logging that  will
  2109.          be used, will depend on other options. Inside the log-file  you
  2110.          will  see  information,  statistics,  warnings  and errors. The
  2111.          earlier MTA versions contained a ErrorLogPath option. With  the
  2112.          15.01 release (and higher) this option has become obsolete.
  2113.  
  2114.  Relate: LogStyleFormat
  2115.  Dest. : All
  2116.  
  2117.  
  2118.  ┌─────────────────────────────────────────────────────────────────────┐
  2119.  │ AVLogPath [dir]                                                     │
  2120.  │ AVLogPath [path]                                                    │
  2121.  └─────────────────────────────────────────────────────────────────────┘
  2122.  Usage : MTA can log AV-codes and names. Under normal conditions you can
  2123.          choose not to log (it will  speed things up a little) but  then
  2124.          you will  not  be  able  to  see which AV-codes belong to which
  2125.          authors. This  log-file  will  contain AV-numbers (from ZIP and
  2126.          ARJ files) and  the  names that belong to that numbers. The log
  2127.          can be a help when you setup the IncludeAVFile option(s). Never
  2128.          point  to  the  same  log as in the LogPath option. The general
  2129.          format  of  the  AV-log  is quite different than the normal log
  2130.          that MTA maintains !
  2131.          There are two different ways you can setup the logging:
  2132.  
  2133.          [dir]         This value must point to a valid  drive/directory
  2134.                        where logging  will take  place. If  no drive  is
  2135.                        supplied,  the  default  one  is  used.  Relative
  2136.                        directories (..\WRKDIR and such) are not  advised
  2137.                        but  can  be  used  (the  are  counted  from  the
  2138.                        CURRENT directory).   In this  case MTA  will try
  2139.                        to open the file  with the name MTA.LOG  and will
  2140.                        append  to  it  when  it  is present or create it
  2141.                        when it is not (yet) available;
  2142.  
  2143.          [path]        This value must point to a valid  drive/directory
  2144.                        and  filename  of  the  log-file.  If no drive is
  2145.                        supplied,  the  default  one  is  used.  Relative
  2146.                        directories (..\WRKDIR and such) are not  advised
  2147.                        but  can  be  used  (the  are  counted  from  the
  2148.                        CURRENT directory).   In this  case MTA  will try
  2149.                        to open the file with the SUPPLIED name and  will
  2150.                        append  to  it  when  it  is present or create it
  2151.                        when it is not (yet) available;
  2152.  
  2153.  Relate: None
  2154.  Dest. : All
  2155.  
  2156.  
  2157.  ┌─────────────────────────────────────────────────────────────────────┐
  2158.  │ NormalPasswordListPath [dir]                                        │
  2159.  │ NormalPasswordListPath [path]                                       │
  2160.  └─────────────────────────────────────────────────────────────────────┘
  2161.  Usage : When  you   create  archives  with passwords  (/OP command-line
  2162.          parameter), MTA will  log these archives  (and passwords) in  a
  2163.          special  log-file.  This  log-file  CAN  be  the  same  as  the
  2164.          log-file that is assigned in the LogPath option or it can be  a
  2165.          different  log.  The  usage  of NormalPasswordListPath is fully
  2166.          optional but if you leave it out and you use passwords for  the
  2167.          target  archives  you  must  remember  the  passwords from your
  2168.          head.
  2169.  
  2170.          [dir]         This value must point to a valid  drive/directory
  2171.                        where logging  will take  place. If  no drive  is
  2172.                        supplied,  the  default  one  is  used.  Relative
  2173.                        directories (..\WRKDIR and such) are not  advised
  2174.                        but  can  be  used  (the  are  counted  from  the
  2175.                        CURRENT directory).   In this  case MTA  will try
  2176.                        to open the file  with the name MTA.NPW  and will
  2177.                        append  to  it  when  it  is present or create it
  2178.                        when it is not (yet) available;
  2179.  
  2180.          [path]        This value must point to a valid  drive/directory
  2181.                        and  filename  of  the  log-file.  If no drive is
  2182.                        supplied,  the  default  one  is  used.  Relative
  2183.                        directories (..\WRKDIR and such) are not  advised
  2184.                        but  can  be  used  (the  are  counted  from  the
  2185.                        CURRENT directory).   In this  case MTA  will try
  2186.                        to open the file with the SUPPLIED name and  will
  2187.                        append  to  it  when  it  is present or create it
  2188.                        when it is not (yet) available;
  2189.  
  2190.  Relate: RandomPasswordListPath, LogStyleFormat
  2191.  Dest. : All
  2192.  
  2193.  
  2194.  ┌─────────────────────────────────────────────────────────────────────┐
  2195.  │ RandomPasswordListPath [dir]                                        │
  2196.  │ RandomPasswordListPath [path]                                       │
  2197.  └─────────────────────────────────────────────────────────────────────┘
  2198.  Usage : MTA has  an option  to assign  RANDOM passwords  to the  target
  2199.          archives (the /OP@ command-line parameter). The files that  are
  2200.          converted and  the passwords  that have  been assigned  to each
  2201.          file MUST be logged. If you  leave out this option and you  use
  2202.          /OP@, MTA will  ENFORCE the logging  in the current  directory,
  2203.          otherwise  it  uses  the  values  that  are  supplied with this
  2204.          option.
  2205.  
  2206.          [dir]         This value must point to a valid  drive/directory
  2207.                        where logging  will take  place. If  no drive  is
  2208.                        supplied,  the  default  one  is  used.  Relative
  2209.                        directories (..\WRKDIR and such) are not  advised
  2210.                        but  can  be  used  (the  are  counted  from  the
  2211.                        CURRENT directory).   In this  case MTA  will try
  2212.                        to open the file  with the name MTA.PWD  and will
  2213.                        append  to  it  when  it  is present or create it
  2214.                        when it is not (yet) available;
  2215.  
  2216.          [path]        This value must point to a valid  drive/directory
  2217.                        and  filename  of  the  log-file.  If no drive is
  2218.                        supplied,  the  default  one  is  used.  Relative
  2219.                        directories (..\WRKDIR and such) are not  advised
  2220.                        but  can  be  used  (the  are  counted  from  the
  2221.                        CURRENT directory).   In this  case MTA  will try
  2222.                        to open the file with the SUPPLIED name and  will
  2223.                        append  to  it  when  it  is present or create it
  2224.                        when it is not (yet) available;
  2225.  
  2226.  Relate: NormalPasswordListPath, LogStyleFormat
  2227.  Dest. : All
  2228.  
  2229.  
  2230.  ┌─────────────────────────────────────────────────────────────────────┐
  2231.  │ LogStyleFormat [styleformat]                                        │
  2232.  └─────────────────────────────────────────────────────────────────────┘
  2233.  Usage : MTA creates  several log-records  under different   conditions.
  2234.          You  can  use  the  standard  log,  but  Sysop's hate all these
  2235.          different log-files  (in general).   MTA can  create customized
  2236.          log-records. With this option,  you can instruct MTA  to create
  2237.          records that  look the  same as  the records  from your  mailer
  2238.          and/or  BBS  program.    The  option  LogStyleFormat  and   the
  2239.          following LogDateFormat/LogTimeFormat  combination can  be used
  2240.          to define  the style  of the  log-records that  MTA will create
  2241.          for  ALL  three   log-files  (LogPath,   NormalPasswordListPath
  2242.          RandomPasswordListPath   log-files).     These   options    are
  2243.          implemented with the idea  that different log-styles only  vary
  2244.          at the start of the records and NOT at the end.
  2245.  
  2246.          The LogStyleFormat  defines the  'structure' of  the log-record
  2247.          header. The format is free but with three special cases:
  2248.  
  2249.          - Spaces must be replaced by underscore characters '_';
  2250.  
  2251.          - The  part  of  the  record  that  contains  the date must  be
  2252.            defined with %D (if a date is wanted);
  2253.  
  2254.          - The  part  of  the  record  that  contains  the time must  be
  2255.            defined with %T (if a time is wanted);
  2256.  
  2257.          - Any  extra CRLF  combinations (to  create a  separation line)
  2258.            must be defined with ^M;
  2259.  
  2260.          [styleformat] This  is  the  actual  string  that  defines  the
  2261.                        format of the log-header. You can use two  macros
  2262.                        inside this string, the %T that will be  replaced
  2263.                        with the time  in the format  as supplied in  the
  2264.                        LogTimeFormat  option   and  %D   that  will   be
  2265.                        replaced with the date in the format as  supplied
  2266.                        in  the  LogDateFormat  option.  You must observe
  2267.                        the 4 rules that are described above;
  2268.  
  2269.          An example  (also read  LogDateFormat and  LogTimeFormat for  a
  2270.          description  of  the  time  and  date  functions).  You want to
  2271.          create records that look like this:
  2272.  
  2273.          +  6 Jan 1990   2:00p   The-start-of-the-log
  2274.  
  2275.          The 'The-start-of-the-log' part  is constructed by  MTA itself,
  2276.          so  you  have  only  to  define  the  header.  This  is done as
  2277.          follows:
  2278.  
  2279.          LogStyleFormat +_%D__%T___       (The '_' replaces the spaces)
  2280.          LogDateFormat  DD_nnn_yyyy
  2281.          LogTimeFormat  HH:mmt
  2282.  
  2283.          %D and %T are  replaced by MTA with  the date and time  formats
  2284.          as  supplied  in   LogDateFormat  and  LogTimeFormat.   MTA.CTL
  2285.          contains  a  number  of  examples  for  the  various BBS/Mailer
  2286.          programs.
  2287.  
  2288.  Relate: LogStartStyleFormat, LogDateFormat, LogTimeFormat
  2289.  Dest. : All
  2290.  
  2291.  
  2292.  ┌─────────────────────────────────────────────────────────────────────┐
  2293.  │ LogStartStyleFormat [styleformat]                                   │
  2294.  └─────────────────────────────────────────────────────────────────────┘
  2295.  Usage : This   is  an   additional    option  you   can use along  with
  2296.          the previous   LogStyleFormat  option.   Some  types   of   log
  2297.          use  a special  format  where   the  actual  date  is put  into
  2298.          an extra record  (with- out any   further meaning than  logging
  2299.          the date).   MTA can create  such a record   for you. MTA  will
  2300.          put   the     record   with   the   format   you   supply    in
  2301.          LogStartStyleFormat into the  log as the first and only  record
  2302.          for THIS run of MTA. If MTA  stops and is started again, a  new
  2303.          record of this type is written.
  2304.  
  2305.          [styleformat] This  is  the  actual  string  that  defines  the
  2306.                        format of  the log-file  start. You  can use  two
  2307.                        macros inside  this string,  the %T  that will be
  2308.                        replaced with the time in the format as  supplied
  2309.                        in the LogTimeFormat option  and %D that will  be
  2310.                        replaced with the date in the format as  supplied
  2311.                        in  the  LogDateFormat  option.  You must observe
  2312.                        the 4 rules that are described above;
  2313.  
  2314.          A type of log with this  format is found in the FrontDoor  <tm>
  2315.          mailer. The  options you  can use  in this  logstyle-format are
  2316.          the same as with the LogStyleFormat option.
  2317.  
  2318.  Relate: LogStyleFormat, LogDateFormat, LogTimeFormat
  2319.  Dest. : All
  2320.  
  2321.  
  2322.  ┌─────────────────────────────────────────────────────────────────────┐
  2323.  │ LogDateFormat [styleformat]                                         │
  2324.  └─────────────────────────────────────────────────────────────────────┘
  2325.  Usage : LogDateFormat is used to define the 'date part' (actually the
  2326.          %D) in the LogStyleFormat option. MTA can is able to replace a
  2327.          number of characters (macros) by parts that make up the date.
  2328.          You can (must) also include special date-separation characters
  2329.          so your newly created date will actually look like a data !
  2330.  
  2331.          [styleformat] This is the actual string that defines the
  2332.                        format of the %D macros, used in the options
  2333.                        LogStyleFormat and LogStartStyleFormat. The
  2334.                        [styleformat] must be coded in the format you
  2335.                        want the date to have. Spaces, used as the
  2336.                        separation between components of the date, must
  2337.                        be coded as spaces (and not as '_' characters).
  2338.                        The following codes can be used:
  2339.  
  2340.                        mm    Month with a (optionally) leading zero
  2341.  
  2342.                        MM    Month  ,,         ,,         ,,   space
  2343.  
  2344.                        dd    Day    ,,         ,,         ,,   zero
  2345.  
  2346.                        DD    Day    ,,         ,,         ,,   space
  2347.  
  2348.                        yy    Year  (format: 92  )
  2349.  
  2350.                        yyyy  Year  (format: 1992)
  2351.  
  2352.                        nnn   Name of the  month (with mixed  case,  like
  2353.                              Jan, Oct  and so  on). The  length of 'nnn'
  2354.                              will  rule  the  length  of  the  name,  so
  2355.                              'nnnn' will be replaced by 'Janu';
  2356.  
  2357.                        NNN   Name of  the month  (UPPER case,  like  JAN
  2358.                              OCT and  so on).  The length  of 'nnn' will
  2359.                              rule  the  length  of  the  name, so 'NNNN'
  2360.                              will be replaced by 'JANU';
  2361.  
  2362.                        www   Name of  the day  (with mixed  case,   like
  2363.                              Fri, Sat  and so  on). The  length of 'www'
  2364.                              will  rule  the  length  of  the  name,  so
  2365.                              'wwww' will be replaced by 'Frid';
  2366.  
  2367.                        WWW   Name of  the month  (UPPER case,  like  FRI
  2368.                              SAT and  so on).  The length  of 'nnn' will
  2369.                              rule  the  length  of  the  name, so 'WWWW'
  2370.                              will be replaced by 'FRID';
  2371.  
  2372.          Some valid examples (notice the separation characters that  are
  2373.          coded between the macros):
  2374.  
  2375.          mm/dd/yy         01/31/90
  2376.          MM-dd-yy          1-31-90
  2377.          dd/mm/yyyy       31/01/1990
  2378.          dd/mm/yyyy       31/01/1990
  2379.          dd NNN yyyy      31 JAN 1990
  2380.          dd nnn yy        31 Jan 1990
  2381.          dd n yyyy        31 J 1990
  2382.          www dd nnn yyyy  Sun 31 Jan 1990
  2383.  
  2384.  Relate: LogStyleFormat, LogStartStyleFormat
  2385.  Dest. : All
  2386.  
  2387.  
  2388.  ┌─────────────────────────────────────────────────────────────────────┐
  2389.  │ LogTimeFormat [styleformat]                                         │
  2390.  └─────────────────────────────────────────────────────────────────────┘
  2391.  Usage : LogTimeFormat is used  to define the 'time part'  (actually the
  2392.          %T) in the LogStyleFormat option. MTA can is able to replace  a
  2393.          number of characters (macros) by  parts that make up the  time.
  2394.          You can (must) also include special time-separation  characters
  2395.          so your newly created time will actually look like a time !
  2396.  
  2397.          [styleformat]  This  is  the  actual  string  that  defines the
  2398.                        format  of  the  %T  macros,  used in the options
  2399.                        LogStyleFormat   and   LogStartStyleFormat.   The
  2400.                        [styleformat]  must  be  coded  in the format you
  2401.                        want  the  time  to  have.  Spaces,  used  as the
  2402.                        separation between components  of the time,  must
  2403.                        be coded as spaces  (and not as '_'  characters).
  2404.                        The following codes can be used:
  2405.  
  2406.                        hh    Hour  with a (optionally) leading zero
  2407.  
  2408.                        HH    Hour   ,,         ,,         ,,   space
  2409.  
  2410.                        mm    Min    ,,         ,,         ,,   zero
  2411.  
  2412.                        MM    Min    ,,         ,,         ,,   space
  2413.  
  2414.                        ss    Sec    ,,         ,,         ,,   zero
  2415.  
  2416.                        SS    Sec    ,,         ,,         ,,   zero
  2417.  
  2418.                        t     will be replaced by 'p' (in pm) or 'a'  (in
  2419.                              am);
  2420.  
  2421.                        T     will be replaced by 'P' (in PM) or 'A'  (in
  2422.                              AM);
  2423.  
  2424.                        e     will be  replaced with 'm'  (in am or   pm)
  2425.                              and must be combined with 'T' or 't';
  2426.  
  2427.                        E     will be  replaced with 'M'  (in AM or   PM)
  2428.                              and must be combined with 'T' or 't';
  2429.  
  2430.                        If   you    leave   out    any    't'/'T'/'e'/'E'
  2431.                        combination, the time will be in 24-hour format.
  2432.  
  2433.          Some  valid  examples  (notice  the  separation characters that
  2434.          are coded between the macros):
  2435.  
  2436.          hh:mm            14:00
  2437.          hh.mmt           02.00p
  2438.          HH:mmte           2:00pm
  2439.          HH:mm:ss         14:00:45
  2440.          hh:mm:ss         14:00:45
  2441.  
  2442.  Relate: LogStyleFormat, LogStartStyleFormat
  2443.  Dest. : All
  2444.  
  2445.  
  2446.  
  2447.  3.3.4 Statements that define the selection of files
  2448.  ───────────────────────────────────────────────────────────────────────
  2449.  There are several options in MTA.CTL that rule the selection of  files.
  2450.  Most of  them are  described in  this chapter.  Those which  have to do
  2451.  with  the  selection  of  files  in  a BBS environment (SysOp's) can be
  2452.  found in the chapter that describes the special BBS parameters.
  2453.  
  2454.  ┌─────────────────────────────────────────────────────────────────────┐
  2455.  │ DefaultPath [dir] {targetdir}                                       │
  2456.  └─────────────────────────────────────────────────────────────────────┘
  2457.  Usage : Without any  special options,  MTA will  start working  in  the
  2458.          current directory. There are several ways to overrule this  (by
  2459.          default in MTA.CTL or temporary  on the command-line).  One  of
  2460.          the  options  that  can  be  used  by both BBS operators and by
  2461.          normal users, is this DefaultPath option. With this option  you
  2462.          force MTA  to convert  files that  are in  the directories that
  2463.          you supply on one or more (up to 255) DefaultPath options.
  2464.  
  2465.          If you  don't do  special actions  AND you  leave the converted
  2466.          files inside  the directories  that you  assign with  the FIRST
  2467.          parameter of this option, MTA will convert them AGAIN when  you
  2468.          start MTA for the second  (and further) time. You can  fix this
  2469.          problem  by  either  marking  the   files  as  done  (see   the
  2470.          MarkString  related  options)  or  by  using  the  OnlyNewFiles
  2471.          option  or  by  moving  them  to  another directory that is not
  2472.          touched by MTA, either automatically or by hand.
  2473.  
  2474.          The selection of  which files inside  these directories are  to
  2475.          be converted is  ruled by the  file-mask(s) that you  supply on
  2476.          the command-line.
  2477.  
  2478.          [dir]         This value must point to a valid  drive/directory
  2479.                        where conversion will take place. If no drive  is
  2480.                        supplied,  the  default  one  is  used.  Relative
  2481.                        directories (..\WRKDIR and such) are not  advised
  2482.                        but  can  be  used  (the  are  counted  from  the
  2483.                        CURRENT directory).
  2484.  
  2485.          {targetdir}   This value  CAN point to a valid  drive/directory
  2486.                        where  files  that  are  converted  in  [dir] are
  2487.                        moved to AFTER the conversion. If no  {targetdir}
  2488.                        is   supplied,   the   files   stay   in   [dir].
  2489.                        Relative  directories  (..\WRKDIR  and  such) are
  2490.                        not  advised  but  can  be  used (the are counted
  2491.                        from the  CURRENT directory).  This parameter  is
  2492.                        optional !!
  2493.  
  2494.          There can  be up  to 255  DefaultPath options.  You can mix the
  2495.          formats (some  of them  can have  a {targetdir},  some of  them
  2496.          don't have this parameter).
  2497.  
  2498.          If  you  use  the  /W  command-line  parameter, the DefaultPath
  2499.          options are ignored ! If  you use the full-screen selection  of
  2500.          files (MTA is  started without any  file-mask), ONLY the  first
  2501.          directory is  converted and  all other  DefaultPath options are
  2502.          ignored !
  2503.  
  2504.  Relate: QBBSPaths, RAPaths (for BBS systems)
  2505.  Dest. : All
  2506.  
  2507.  
  2508.  ┌─────────────────────────────────────────────────────────────────────┐
  2509.  │ DoNot [filemask]                                                    │
  2510.  │ DoNot [path]                                                        │
  2511.  └─────────────────────────────────────────────────────────────────────┘
  2512.  Usage : When   you   use     MTA      unattended   or   you     convert
  2513.          complete directories   (with  f.i.   DefaultPath  options)   it
  2514.          is possible  that   files   are   converted   that   you  don't
  2515.          want to convert.  Examples of  these files  are many  but  most
  2516.          commonly, you can think of files that  came from programs  like
  2517.          XRS (734B0384.TU1 and such) or  files that have a public  usage
  2518.          (like  NODEDIFF.A23 and such).
  2519.  
  2520.          The DoNot option  can be used  to exclude some  files EVEN when
  2521.          they match  the file-mask  selection on  the command-line.  You
  2522.          can use up to 255 of EACH these options (so 255 with [path] AND
  2523.          255 with [filemask]).
  2524.  
  2525.          [path]        This parameter must contain a complete path with
  2526.                        filemask,  so drive, directory and filemask like
  2527.                        in E:\ZIP\*.A??.  Wildcards  in the filemask can
  2528.                        be used (see below);
  2529.  
  2530.          [filemask]    The parameter must  contain a single   file-mask.
  2531.                        You  can  use  the  normal  DOS  wildcards (?,*).
  2532.                        Also  a  special  wildcard  (=)  can be used. '='
  2533.                        will test  for a  shifting match.  So '=WAR' will
  2534.                        match  tradeWAR.zip  and  also  WARning.ARC.  =FZ
  2535.                        will NOT  match with  nodedifF.Zip. In  this case
  2536.                        you  must  use  =F.Z;
  2537.  
  2538.          When using the /D and AllDisketteFiles options together,  files
  2539.          are NEVER excluded.  This is also  the case when  MTA does call
  2540.          to itself (compressed-in-compressed files).
  2541.  
  2542.  Relate: None
  2543.  Dest. : All
  2544.  
  2545.  
  2546.  ┌─────────────────────────────────────────────────────────────────────┐
  2547.  │ SFXFiles                                                            │
  2548.  └─────────────────────────────────────────────────────────────────────┘
  2549.  Usage : With  archive conversion you  have to deal  with so called  SFX
  2550.          files. These  are SelF  eXtracting archives.  In general,  this
  2551.          are normal COM or  EXE files that can  be started as a  program
  2552.          and which task  only is to  decompress all files  that are also
  2553.          inside  this  COM/EXE  file.  SFX  files  are commonly used for
  2554.          distribution of  the archive  programs them  self. It  would be
  2555.          rather  difficult  to  decompress  PKZ110.ZIP  if  this was the
  2556.          first time you got  involved with ZIP, so  such a file will  be
  2557.          distributed as PKZ110.EXE.
  2558.  
  2559.          MTA is able to convert SFX files into a new target system.   To
  2560.          do so, it must be able to recognize such a file as an  archive.
  2561.          These is a lot of coding involved  in MTA to do so and I  won't
  2562.          say that the coding  can trap 100% of  each cases.  Most  other
  2563.          products that  involve archives  will tell  you that  they will
  2564.          recognize SFX  files for  100% but  most of  them will  fail on
  2565.          occasion. A SFX archive contains some executable coding at  the
  2566.          start of the archive.  MTA must be able  (and is) to skip  this
  2567.          coding  and  to  look  for  the  archive  part.  To keep MTA as
  2568.          'generic' as possible, there is no SPECIFIC code for each  type
  2569.          of header.  This would  make maintenance  almost an  impossible
  2570.          job because the headers change with every new version of  every
  2571.          archive that supports  SFX archives. Up  to now, MTA  has never
  2572.          failed its  job BUT  it is  possible that  MTA will recognize a
  2573.          normal  EXE/COM  file  as  being  a  SFX  file.   This is not a
  2574.          problem because the decompression of such a file will fail  and
  2575.          the file will stay as it is.
  2576.  
  2577.          Normally MTA  will NOT  (by default)  convert SFX  archives. If
  2578.          you  supply  this  option,  MTA  will also start converting SFX
  2579.          files  if  they  match  the  file-masks  that you supply on the
  2580.          command-line.
  2581.  
  2582.  Relate: None
  2583.  Dest. : All
  2584.  
  2585.  
  2586.  ┌─────────────────────────────────────────────────────────────────────┐
  2587.  │ MaxGifDim [w] [h] [c]                                               │
  2588.  └─────────────────────────────────────────────────────────────────────┘
  2589.  Usage : This  option  rules   the  selection  of GIF files. It  is only
  2590.          needed when you  run the unregistered  version of GIFLITE  <tm>
  2591.          but  will  also  work  for  GIF  to JPEG conversions. With this
  2592.          option you instruct MTA only to select GIF files that have  the
  2593.          same or a  lower resolution. The  option is ignored  when using
  2594.          GIF as  the compression  type (GIFTEST).  For this  conversion,
  2595.          you   can   add   a   command-line   parameter   for    GIFTEST
  2596.          (GTECompression option) in which  case GIFTEST will reject  all
  2597.          GIF files with dimensions LOWER than a specific one.
  2598.  
  2599.          [w] [h] [c]   With this  3 parameters you  define the   maximum
  2600.                        resolution of  GIF files  what will  be selected.
  2601.                        The values 640  480 256 will  be useful when  you
  2602.                        use the  unregistered version  of GIFLITE,  other
  2603.                        values can be set to narrow the selection.
  2604.  
  2605.          Please notice that  the three parameters  have an OR  relation.
  2606.          If one of them is smaller  than the actual resolution of a  GIF
  2607.          file, the  file is  not selected.  So a  641*479*255 GIF is NOT
  2608.          selected when  the option  is set  to 640  480 256  because the
  2609.          weight (641) is higher than 640.
  2610.  
  2611.  Relate : GIFLite
  2612.  Dest   : GIF types
  2613.  
  2614.  
  2615.  ┌─────────────────────────────────────────────────────────────────────┐
  2616.  │ NoMarked                                                            │
  2617.  └─────────────────────────────────────────────────────────────────────┘
  2618.  Usage : What if you have one or more directories that contain  archives
  2619.          and where you want to  convert ONLY archives that haven't  been
  2620.          converted before ? So a directory contains 20 ZIP archives  and
  2621.          each period, you move 1  or more new archives (ALSO  containing
  2622.          ZIP archives amongst others)  to this directory. You  only want
  2623.          to convert  these 1  or more  archives once,  without having to
  2624.          convert the other 20. This is  a normal problem on a BBS  where
  2625.          various archives are stored  in the upload-space and  the Sysop
  2626.          only wants to convert the newly uploaded archives.
  2627.  
  2628.          There are two  ways to do  it. One is  to use the  OnlyNewFiles
  2629.          option (see  later), but  this is  a very  primitive (but fast)
  2630.          way. The other is to use MTA's Archive Marking System <tm>.
  2631.  
  2632.          When AMS is active, MTA  will convert an archive and  after the
  2633.          conversion is finished,  MTA will add  a special string  at the
  2634.          end of the  archive. This string  is made up  with some special
  2635.          information that will be unique. When MTA runs again, the  file
  2636.          is read and MTA will detect that this string is present. If  it
  2637.          is, MTA will ignore the archive (unless AMS is switched off).
  2638.  
  2639.          If, for  some reason,  you want  to remove  the special string,
  2640.          you can run MTM (a support  utility in this package) to do  so.
  2641.          Also, when  you want  to start  using AMS  and you already have
  2642.          many converted  archives, you  can use  MTM to  add the  string
  2643.          (called the mark-string) to all these files, without having  to
  2644.          convert them.
  2645.  
  2646.          AMS will  be active  when NoMarked  is set  to on.  This option
  2647.          will instruct MTA to look if an archive contains a  mark-string
  2648.          and if so, if  it is the one  that you use on  your system. The
  2649.          mark-string can be created (and made unique) by yourself !
  2650.  
  2651.          All compressors  have been  tested with  this extra information
  2652.          appended and they seem to have no trouble with it. That is  not
  2653.          so strange if you  know that some communication  protocols will
  2654.          append binary  zeroes to  a file,  when transferred,  to fill a
  2655.          complete transfer block.
  2656.  
  2657.          A special word about  the mark-string information. If  everyone
  2658.          should use MTA's default and should download a file,  converted
  2659.          with MTA/NoMarked  and would  like to  convert this  file again
  2660.          with MTA/NoMarked, the file would be ignored. It is advised  to
  2661.          set your  own marker  with the  MarkString option  to something
  2662.          more or  less private.  BBS's could  enter their Node/Net/Point
  2663.          number or the name of the SysOp or something like  Ghostbuster,
  2664.          Snoopy or whatsoever.
  2665.  
  2666.          Another piece of advise. Many  BBS Sysop's like to convert  all
  2667.          files in the  upload-space to see  if there is  a virus inside.
  2668.          MTA is  perfect to  do that  job BUT  you must  be careful with
  2669.          your mark-string. If users can download archives from you  that
  2670.          contain the mark-string, they are able to upload archives  with
  2671.          a virus AND YOUR mark-string also. When this file is placed  in
  2672.          the upload-directory and you use the NoMarked option, MTA  will
  2673.          ignore the  archive because  it already  contains your mark-ID.
  2674.          You can use one of the following scenarios:
  2675.  
  2676.          - Use the  mark-string in the  upload directory conversion  but
  2677.            remove the  string (with  MTM) before  the file  is available
  2678.            for download (when moved to its own directory);
  2679.  
  2680.          - Don't use  the mark-string in  your upload-directory but  use
  2681.            it only in your normal directories;
  2682.  
  2683.          - Don't use the  mark-string in your upload-directory  (run MTM
  2684.            to remove any),  then convert the  file with NoMark  and move
  2685.            it at once to another directory. When MTA is used as an  exit
  2686.            to the  protocol-driver in  your BBS  (you can  use FileDoor,
  2687.            another DISP product, to do so), you can set up marking in  a
  2688.            save way  (convert ALL  archives that  are uploaded  and only
  2689.            convert  archives  that  are   not  marked  in  your   upload
  2690.            directory);
  2691.  
  2692.          NoMarked  has  no  meaning  when  using  /D  with  the AllFiles
  2693.          option.  The mark is not set when the MoveToDir option (/M)  is
  2694.          used.
  2695.  
  2696.  Relate: MoveToDir, /D, MarkString
  2697.  Dest. : All
  2698.  
  2699.  
  2700.  ┌─────────────────────────────────────────────────────────────────────┐
  2701.  │ MarkHeader [markstring]                                          (*)│
  2702.  └─────────────────────────────────────────────────────────────────────┘
  2703.  Usage : The  mark-string that is  used by MTA  to test if  archives are
  2704.          already converted and which is  added to new archives when  the
  2705.          NoMarked option is set, is made up of two parts, the so  called
  2706.          header and  the actual  string). Both  have a  default but when
  2707.          you work with  the NoMarked option,  you should AT  LEAST alter
  2708.          the value of the  string and you COULD  alter the value of  the
  2709.          header also. If you  don't alter one or  both of them, it  will
  2710.          be  possible  that  someone  else  supplies an archive with the
  2711.          same values as  you use (because  they didn't alter  the header
  2712.          also).
  2713.  
  2714.          [markstring]  This must  be a  6 byte  long value  you want  to
  2715.                        assign to the  header. The default  is 3 times  a
  2716.                        binary zero and the  upper-case word MTA. If  you
  2717.                        supply less  than 6  bytes, the  header is filled
  2718.                        up to 6 bytes with spaces.
  2719.  
  2720.          If, for  some reason,  you change  [markstring] after  you have
  2721.          converted one  or more  archives with  the older  [markstring],
  2722.          you must run  MTM to convert  [markstring] to the  new value in
  2723.          those archives that have the old value.
  2724.  
  2725.  Relate: NoMarked, MarkString
  2726.  Dest. : All
  2727.  (*)   : Marked options are also in usage by: MTM
  2728.  
  2729.  
  2730.  ┌─────────────────────────────────────────────────────────────────────┐
  2731.  │ MarkString [string]                                              (*)│
  2732.  └─────────────────────────────────────────────────────────────────────┘
  2733.  Usage : The  mark-string that is  used by MTA  to test if  archives are
  2734.          already converted and which is  added to new archives when  the
  2735.          NoMarked option is set, is made up of two parts, the so  called
  2736.          header and  the actual  string). Both  have a  default but when
  2737.          you work with  the NoMarked option,  you should AT  LEAST alter
  2738.          the value of the  string and you COULD  alter the value of  the
  2739.          header also. If you  don't alter one or  both of them, it  will
  2740.          be  possible  that  someone  else  supplies an archive with the
  2741.          same values as  you use (because  they didn't alter  the header
  2742.          also).
  2743.  
  2744.          [markstring]  This  must be a  14 byte long  value you want  to
  2745.                        assign to the string.  The default has the  value
  2746.                        'MTAYour ID here !'.  If you supply less  than 14
  2747.                        bytes, the string is  filled up to 14  bytes with
  2748.                        spaces.
  2749.  
  2750.          If, for  some reason,  you change  [markstring] after  you have
  2751.          converted one  or more  archives with  the older  [markstring],
  2752.          you must run  MTM to convert  [markstring] to the  new value in
  2753.          those archives that have the old value.
  2754.  
  2755.  Relate: NoMarked, MarkString
  2756.  Dest. : All
  2757.  (*)   : Marked options are also in usage by: MTM
  2758.  
  2759.  
  2760.  ┌─────────────────────────────────────────────────────────────────────┐
  2761.  │ UnMark                                                              │
  2762.  └─────────────────────────────────────────────────────────────────────┘
  2763.  Usage : Unmark  overrules  the   NoMark  option and should not be  used
  2764.          together with it. The option  is there for those special  cases
  2765.          where  an  archiver  is  not  able  to decompress a file with a
  2766.          mark-string at  the end.  The earlier  (older) LHA.EXE programs
  2767.          (2.0x series, the 2.1x series  work ok), would fail with  a CRC
  2768.          check when the  file was longer  than the length  calculated by
  2769.          LHA itself. This foolish option  is removed from LHA and  there
  2770.          is no current usage for the option.
  2771.  
  2772.  Relate: NoMarked, MarkHeader
  2773.  Dest. : All
  2774.  
  2775.  
  2776.  ┌─────────────────────────────────────────────────────────────────────┐
  2777.  │ OnlyNewFiles                                                        │
  2778.  └─────────────────────────────────────────────────────────────────────┘
  2779.  Usage : This  option  works   something  different  than  the  NoMarked
  2780.          option.  When set,  MTA will look for  a file FILES.MTA in  the
  2781.          directory where  the source-archives  are.   MTA will  read the
  2782.          date/time of this file and  EVERY file with a date/time  HIGHER
  2783.          than the date/time of FILES.MTA will be converted.  At the  end
  2784.          of the conversion, MTA will  set the dat/time of the  FILES.MTA
  2785.          to the current date and time.
  2786.  
  2787.          If no   FILES.MTA is   present, MTA   will assume   0 for  both
  2788.          the date   and  time   (resulting  in   a  conversion   of  ALL
  2789.          selected files)  and will  create the  file when  conversion is
  2790.          done.
  2791.  
  2792.  Relate: None
  2793.  Dest. : All
  2794.  
  2795.  ┌─────────────────────────────────────────────────────────────────────┐
  2796.  │ DelOldFiles [mm-yyyy] {action}                                      │
  2797.  └─────────────────────────────────────────────────────────────────────┘
  2798.  Usage : MTA   is able to   do some maintenance   for you also.    Users
  2799.          with big  libraries  of   archives  would  like  to  clean some
  2800.          of the older  ones, once in  a  while.  Also, BBS SysOp's  like
  2801.          to  remove  uploaded  files   when  they   are  too   old. Most
  2802.          protocol drivers (also FileDoor) have   such options but   most
  2803.          of them  only look at the file date (FileDoor looks inside  the
  2804.          archive). With  MTA you can  assign a  file date  that  depends
  2805.          on the files inside the  archives  (see  later).  If  you   did
  2806.          so, you can  use this option  to clean your  library from older
  2807.          files.
  2808.  
  2809.          [mm-yyyy]     Is the  month (2 bytes,  use leading zeros)   and
  2810.                        yyyy is the year of the oldest files you want  to
  2811.                        KEEP in your library.  If the file date  is lower
  2812.                        than [mm-yyyy], MTA  will do something  with that
  2813.                        file,  depending  on  the  presence of the second
  2814.                        parameter and the DelOldPath option;
  2815.  
  2816.          {action}      {action} can have the following values:
  2817.  
  2818.                        NONE  : MTA  will sound  the bell  (if NoBeep  is
  2819.                                not set and WarningTime is not zero)  and
  2820.                                will   give   a   warning.   The   actual
  2821.                                manipulation of the file will follow;
  2822.  
  2823.                        NOMSG : MTA will  not sound  the bell,  nor  will
  2824.                                there be any message;
  2825.  
  2826.                        ASK   : MTA will  ask the user if this file  must
  2827.                                be manipulated  or not.  The file  IS too
  2828.                                old  (otherwise  no  questions  will   be
  2829.                                asked)  but  it  allows  you  to manually
  2830.                                exclude  some  of  the  files  from   the
  2831.                                manipulation  that  will  follow. You can
  2832.                                answer 'Y'  or 'N'.  This parameter  must
  2833.                                not  be  used  when  you  want to run MTA
  2834.                                unattended.
  2835.  
  2836.          If the DelOldPath option is NOT  set and the file IS marked  as
  2837.          too old (either direct or  after a positive reply when  you use
  2838.          the  ASK  parameter),  MTA  will   DELETE  the  file.  If   the
  2839.          DelOldPath option IS set and the file IS marked, MTA will  MOVE
  2840.          the file to the directory assigned in the DelOldPath option.
  2841.  
  2842.  Relate: DelOldPath
  2843.  Dest. : All
  2844.  
  2845.  
  2846.  ┌─────────────────────────────────────────────────────────────────────┐
  2847.  │ DelOldPath [dir]                                                    │
  2848.  └─────────────────────────────────────────────────────────────────────┘
  2849.  Usage : If DelOldFiles  is set  and a  file is  marked as too old,  MTA
  2850.          will delete the file, unless you supply the DelOldPath  option.
  2851.          If this  option is  supplied, MTA  will MOVE  (not delete)  the
  2852.          file to the assigned directory.
  2853.  
  2854.          [dir]         This value must point to a valid  drive/directory
  2855.                        where the files  are moved to  when they are  too
  2856.                        old.  If  no drive is  supplied, the default  one
  2857.                        is  used.   Relative  directories  (..\WRKDIR and
  2858.                        such) are not  advised but can  be used (the  are
  2859.                        counted from the CURRENT directory).
  2860.  
  2861.  Relate: DelOldFiles
  2862.  Dest. : All
  2863.  
  2864.  
  2865.  3.3.5 Statements that define the resulting files
  2866.  ───────────────────────────────────────────────────────────────────────
  2867.  MTA  includes  a  number  of  options  that  will  rule  the  resulting
  2868.  archives.   These include  optimizing the  files, the  comments to add,
  2869.  the files to add and remove from the archive and so on.
  2870.  
  2871.  ┌─────────────────────────────────────────────────────────────────────┐
  2872.  │ ExcludeFile [filemask]                                           (*)│
  2873.  └─────────────────────────────────────────────────────────────────────┘
  2874.  Usage : Today there can be no archive that does not include some  files
  2875.          that have no relation with the actual archive but which  is/are
  2876.          added as some sort of advertisement. Every BBS adds, at  least,
  2877.          a comment in the  archive, so you can  read over and over  from
  2878.          which BBS the file came but there are also BBS Sysop's who  add
  2879.          files  to  the  archive  with  the same (or other) information.
  2880.          When I  had to  choose, I  would like  to see  NONE of the both
  2881.          ways (all the extra  bytes will cause longer  connections, thus
  2882.          costing money) but if  I had to choose  between one of them,  I
  2883.          would rather like to see included files than archive  comments.
  2884.          The included files are  compressed (thus costing less  transfer
  2885.          time)  but  the  comments  are  not  !  I wait for the day that
  2886.          SysOp's start to add  GIF's (640*480*256 or higher)  with their
  2887.          own  pictures.  In  that  case  we  all  can  have  fun when we
  2888.          download  an  archive  with  2   Kb  programs  and  300Kb   GIF
  2889.          advertisements !
  2890.  
  2891.          Normally, when you  obtain archives with  added advertisements,
  2892.          you would  like to  remove them  as soon  as possible. There is
  2893.          one thing positive about it, MOST SysOp's use the same name  of
  2894.          the  included  file(s)  over  and  over.  MTA  can remove these
  2895.          files, based  on their  name, AFTER  the decompression  AND the
  2896.          check for any virus. So  these files ARE included in  the check
  2897.          for a virus.
  2898.  
  2899.          [filemask]    The parameter must  contain a single   file-mask.
  2900.                        You  can  use  the  normal  DOS  wildcards (?,*).
  2901.                        Also  a  special  wildcard  (=)  can be used. '='
  2902.                        will test  for a  shifting match.  So '=WAR' will
  2903.                        match  tradeWAR.zip  and  also  WARning.ARC.  =FZ
  2904.                        will NOT  match with  nodedifF.Zip. In  this case
  2905.                        you  must  use  =F.Z.   You  must  only include a
  2906.                        file-mask and not a directory and/or drive;
  2907.  
  2908.          The  usage  of  the  '='  wildcard  can be handy when the SysOp
  2909.          alters the name of his/her  include file now and then.  In most
  2910.          cases you will see a range like this:
  2911.  
  2912.          JOHNDOE.ADD $JOHNDOE.ADD
  2913.          JOHNDOE$.ADD JOHNDOE.$$$
  2914.  
  2915.          It is a real  pain in the neck  and I can't see  the reason for
  2916.          doing so, but with =JOHNDOE for [filemask], you get rid of  all
  2917.          these files. Don't  use README or  READ.ME. If some  SysOp adds
  2918.          files like this as  an advertisement, they should  think twice.
  2919.          Most of the time, these files contain important info about  the
  2920.          package you have just obtained.
  2921.  
  2922.          You can use up to 255 (!) ExcludeFile statements in MTA.CTL.
  2923.  
  2924.  Relate: IncludeFile
  2925.  Dest. : All
  2926.  (*)   : Marked options are also in usage by: MTM
  2927.  
  2928.  
  2929.  ┌─────────────────────────────────────────────────────────────────────┐
  2930.  │ IncludeFile [path] {newname} {CF$}                               (*)│
  2931.  └─────────────────────────────────────────────────────────────────────┘
  2932.  Usage : See  the  discussion   on  ExcludeFile. This option can do  the
  2933.          reversed. Where  ExcludeFile removes  any advertisement  files,
  2934.          IncludeFile can add your own advertisement !
  2935.  
  2936.          [path]        This value must point to a valid  drive/directory
  2937.                        and filename of the file to include. If no  drive
  2938.                        is supplied, the default  one is used.   Relative
  2939.                        directories (..\WRKDIR and such) are not  advised
  2940.                        but  can  be  used  (the  are  counted  from  the
  2941.                        CURRENT directory);
  2942.  
  2943.          {newname}     This optional  parameter can be  used to   change
  2944.                        the name of the  file assigned with [path]  as it
  2945.                        appears in  the archive.  For example,  if [path]
  2946.                        is   C:\COMMON\MYFILES.ASC   and   {newname}   is
  2947.                        JDOEBBS.ADD,  the  file  inside  the archive will
  2948.                        actually be called JDOEBBS.ADD. If you don't  use
  2949.                        the {newname} parameter, the file will be  called
  2950.                        MYFILES.ASC;
  2951.  
  2952.          {CF$}         This parameter is optional. When you use it,  the
  2953.                        {newname}  parameter  is  mandatory because {CF$}
  2954.                        MUST  be  the  third  parameter  !  When you code
  2955.                        CF$,  you  are  telling  MTA  that  the  file you
  2956.                        include is  in fact  an archive.   In this  case,
  2957.                        MTA will  convert the  included file  to the same
  2958.                        system as the target system for the archive.
  2959.  
  2960.          There can be up to 255 IncludeFile options in the MTA.CTL.  All
  2961.          files will be included  in EVERY converted extension.  When you
  2962.          leave  out  the  option,  nothing  is  included. I hope that no
  2963.          SysOp will use ALL 255 options for advertisement files.
  2964.  
  2965.  Relate: ExcludeFile
  2966.  Dest. : All
  2967.  (*)   : Marked options are also in usage by: MTM
  2968.  
  2969.  
  2970.  ┌─────────────────────────────────────────────────────────────────────┐
  2971.  │ TouchLow                                                            │
  2972.  └─────────────────────────────────────────────────────────────────────┘
  2973.  Usage : This parameter is optional and controls MTA's touching  system.
  2974.          When used, MTA touches (resets the compressed file's  time/date
  2975.          stamp) to  the lowest  date of  any file  inside the compressed
  2976.          file.  All  files  that  match  any supplied ExcludeFile option
  2977.          (see before)  are NOT  looked at.  As an  example, the  archive
  2978.          contains:
  2979.  
  2980.          A.A           12/31/91
  2981.          B.B           11/18/91
  2982.          C.C           01/01/92
  2983.          JOHNDOE.ADD   01/01/91
  2984.  
  2985.          JOHNDOE.ADD is not looked at  because it matches one (or  more)
  2986.          of  the  ExcludeFile  options.  With  TouchLow set, the archive
  2987.          will get the  date 11/18/91 (JOHNDOE.ADD  has a lower  date but
  2988.          is not looked at).
  2989.  
  2990.          When TouchLow is set, TouchCur and  TouchHig  can  not be used.
  2991.          When neither TouchLow  nor  TouchCur  nor TouchHig are set, MTA
  2992.          will retain the original file date/time;
  2993.  
  2994.  Relate: TouchCur, TouchHig, ChildTouch
  2995.  Dest. : All
  2996.  
  2997.  
  2998.  ┌─────────────────────────────────────────────────────────────────────┐
  2999.  │ TouchHig                                                            │
  3000.  └─────────────────────────────────────────────────────────────────────┘
  3001.  Usage : This parameter is optional and controls MTA's touching  system.
  3002.          When used, MTA touches (resets the compressed file's  time/date
  3003.          stamp) to the  highest date of  any file inside  the compressed
  3004.          file.  All  files  that  match  any supplied ExcludeFile option
  3005.          (see before)  are NOT  looked at.  As an  example, the  archive
  3006.          contains:
  3007.  
  3008.          A.A           12/31/91
  3009.          B.B           11/18/91
  3010.          C.C           01/01/92
  3011.          JOHNDOE.ADD   02/01/92
  3012.  
  3013.          JOHNDOE.ADD is not looked at  because it matches one (or  more)
  3014.          of  the  ExcludeFile  options.  With  TouchHig set, the archive
  3015.          will get the date 01/01/92  (JOHNDOE.ADD has a higher date  but
  3016.          is not looked at).
  3017.  
  3018.          When TouchHig is set, TouchCur and  TouchLow  can  not be used.
  3019.          When neither TouchLow  nor  TouchCur  nor TouchHig are set, MTA
  3020.          will retain the original file date/time;
  3021.  
  3022.  Relate: TouchCur, TouchLow, ChildTouch
  3023.  Dest. : All
  3024.  
  3025.  
  3026.  ┌─────────────────────────────────────────────────────────────────────┐
  3027.  │ TouchCur                                                            │
  3028.  └─────────────────────────────────────────────────────────────────────┘
  3029.  Usage : This parameter is optional and controls MTA's touching  system.
  3030.          When used, MTA touches (resets the compressed file's  time/date
  3031.          stamp) to the current date.
  3032.  
  3033.          When TouchCur is set, TouchHig and  TouchLow  can  not be used.
  3034.          When neither TouchLow  nor  TouchCur  nor TouchHig are set, MTA
  3035.          will retain the original file date/time;
  3036.  
  3037.  Relate: TouchLow, TouchHig, ChildTouch
  3038.  Dest. : All
  3039.  
  3040.  
  3041.  ┌─────────────────────────────────────────────────────────────────────┐
  3042.  │ ChildTouch [type]                                                   │
  3043.  └─────────────────────────────────────────────────────────────────────┘
  3044.  Usage : Normally, MTA will use  the same type of touching for  archives
  3045.          inside  archives  (nested  arc-in-arc  files)  as  for the main
  3046.          archive. When this is  not what you want,  you can make use  of
  3047.          this ChildTouch  option to  overrule the  touching with another
  3048.          method for nested archives.
  3049.  
  3050.          [type]        You must either  supply HIGH, LOW, CUR or   FILE.
  3051.                        When HIGH is used,  touching on the highest  date
  3052.                        will  occur  for  nexted  archives,  LOW  for the
  3053.                        lowest date,  CUR for  the current  date and FILE
  3054.                        will cause the original  date to be retained  for
  3055.                        these nested archives.
  3056.  
  3057.          As an example, you can  touch all archives on current  date (so
  3058.          they will show as  new files on a  BBS) but it is  logical that
  3059.          this is not desired for archives inside archives. These  nested
  3060.          archives can be touched in another way if you include this  op-
  3061.          tion;
  3062.  
  3063.  Relate: TouchLow, TouchHig, TouchCur
  3064.  
  3065.  
  3066.  ┌─────────────────────────────────────────────────────────────────────┐
  3067.  │ IgnoreTimeComponent                                              (*)│
  3068.  └─────────────────────────────────────────────────────────────────────┘
  3069.  Usage : This  option  belongs   to  the previous TouchHig and  TouchLow
  3070.          options. When  you use  this option  (you don't  have to),  the
  3071.          time-component  of  the  date/time  of  every  file  inside the
  3072.          archive is ignored. Sometimes you need such an option when  you
  3073.          use software that use the  spare bit of the time/date  field in
  3074.          the  DOS  directory  entry.  There  are  some  programs   (some
  3075.          commercial  backup  programs)  that  do  so. When the option is
  3076.          set, all archives will get the time 00:00:00 when the  TouchHig
  3077.          or TouchLow option is active.
  3078.  
  3079.  Relate: TouchLow, TouchHig
  3080.  Dest. : All
  3081.  (*)   : Marked options are also in usage by: MTM
  3082.  
  3083.  
  3084.  ┌─────────────────────────────────────────────────────────────────────┐
  3085.  │ AcceptHighDate                                                   (*)│
  3086.  └─────────────────────────────────────────────────────────────────────┘
  3087.  Usage : Also this option belongs to the TouchHig and TouchLow  options.
  3088.          Sometimes archives  contain files  with dates  higher than  the
  3089.          current date. MTA  will give a  warning for each  of such files
  3090.          inside any archive because it could be possible that your  PC's
  3091.          date is not correctly set. If this is normal, or if you  expect
  3092.          to receive files with higher (invalid) dates, you must use  the
  3093.          AcceptHighDate option.  The actual  archive will  also get  the
  3094.          high date when TouchLow or TouchHig are in use.
  3095.  
  3096.  Relate: TouchLow, TouchHig
  3097.  Dest. : All
  3098.  (*)   : Marked options are also in usage by: MTM
  3099.  
  3100.  
  3101.  ┌─────────────────────────────────────────────────────────────────────┐
  3102.  │ NoArcInArc                                                          │
  3103.  └─────────────────────────────────────────────────────────────────────┘
  3104.  Usage : MTA will convert  any archives inside archives (in  this manual
  3105.          we call them arc-in-arc files)  up to ANY level deep  (but with
  3106.          respect to the conventional memory available).
  3107.  
  3108.          When running DOS 5.0 on 286, 386 or 486 machines, it is  normal
  3109.          to have  around 600.000  (or more)  bytes of  memory free. With
  3110.          this number of bytes free (and when swapping is used), you  can
  3111.          go up to 80  levels deep (I have  never seen such a  file). You
  3112.          need around 200K to run MTA itself and every MTA child uses  4K
  3113.          extra overhead for swapping.
  3114.  
  3115.          Normally you should  let MTA convert  any archives inside.  But
  3116.          if  memory  is  low,  or  speed  is  slow  or  disk-space  (for
  3117.          swapping)  is  low,  you  CAN  select to leave arc-in-arc files
  3118.          alone. In this case a  TEST.ZIP, containing a TEST.ARJ and  the
  3119.          target is  LZH, will  result in  TEST.LZH containing  TEST.ARJ.
  3120.          When  the  option  is  NOT  set,  it  will  result in TEST.LZH,
  3121.          containing TEST.LZH !
  3122.  
  3123.          For each level of arc-in-arc files, MTA will call itself to  do
  3124.          the  job  on  the  nested  archives,  thus  giving all possible
  3125.          options (with a few restrictions).
  3126.  
  3127.  Relate: None
  3128.  Dest. : All
  3129.  
  3130.  
  3131.  ┌─────────────────────────────────────────────────────────────────────┐
  3132.  │ OptimizeOnSize                                                      │
  3133.  └─────────────────────────────────────────────────────────────────────┘
  3134.  Usage : MTA can also be used to make the smallest possible archive.  It
  3135.          needs a  selection of  different archive  programs to  complete
  3136.          this job  and it  will convert  any archive  to the system that
  3137.          will result in  the smallest archive  (this creating a  mixture
  3138.          of a number of different target systems).
  3139.  
  3140.          All archivers  that are  included in  the xxxPath  options (see
  3141.          3.3.1, the  first options)  and that  have a  'Y' as the second
  3142.          parameter, will be used for testing.
  3143.  
  3144.          YOU must select which archivers  to include in the test.  There
  3145.          are some combinations (that can change when newer versions  hit
  3146.          the street) that are useful.  ZIP, ARJ, LZH and ZOO  (2.1x) can
  3147.          give a good  result. Including MD  or ARJ in  this list has  NO
  3148.          meaning. They ALWAYS result in a bigger archive, but the  given
  3149.          combination works.
  3150.  
  3151.          For  each  archive,  MTA  will  call the selected archivers and
  3152.          will start to  convert the archive  to each of  them (one after
  3153.          another,  only  taking  disk-space  for  one of them). When the
  3154.          smallest is known, MTA will AGAIN start the conversion but  now
  3155.          with ALL possible options (IncludeFile and such) active.
  3156.  
  3157.          OptimizeOnSize  will  cause  MTA  to  run  [number of archivers
  3158.          selected]+1 times longer (average) than normal. Only when  your
  3159.          space is limited, this option should be used !
  3160.  
  3161.  Relate: None
  3162.  Dest. : All
  3163.  
  3164.  
  3165.  ┌─────────────────────────────────────────────────────────────────────┐
  3166.  │ OnlyUpgrade                                                         │
  3167.  └─────────────────────────────────────────────────────────────────────┘
  3168.  Usage : This option can be  useful when you want to convert  your files
  3169.          to  a  higher  technical  level.  In  general, OnlyUpgrade will
  3170.          cause the following files  (also based on the  file-mask(s)) to
  3171.          convert to the new target:
  3172.  
  3173.          - Files  that are  not in  the target  format (e.g.  ZIP is the
  3174.            destination, so all non-ZIP files will be converted);
  3175.  
  3176.          - Files that ARE in the target format (e.g. ZIP and the  target
  3177.            is also ZIP) but that  have a LOWER TECHNICAL level  than the
  3178.            current target;
  3179.  
  3180.          The latter looks  somewhat difficult to  understand, so I  will
  3181.          come to the  point. ZIP, PAK  and LZH have  different levels of
  3182.          archives. You have the older  LZH 1.13 format but the  new 2.xx
  3183.          format is  different, you  have the  older PAK  (crushed) files
  3184.          and today we  have also a  new PAK format  (distilled). For ZIP
  3185.          the same rules apply.
  3186.  
  3187.          In plain english for each archiver involved:
  3188.  
  3189.          - If  the source  and target  are LZH  and the  source contains
  3190.            1.13 formatted  files, conversion  will be  done to  the 2.xx
  3191.            format with LHA;
  3192.  
  3193.          - If  the source  and target  are PAK  and the  source contains
  3194.            crushed  files,  conversion  will  be  done  to the destilled
  3195.            format with PAK;
  3196.  
  3197.          - If  the source  and target  are ZIP  and the  source contains
  3198.            either reduced 1-4 files  or imploded files, conversion  will
  3199.            be  done  to  the  ZIP  2.xx  deflated  format  (the previous
  3200.            versions of  MTA up  to 14.57  only did  an upgrade  from 1-4
  3201.            reduced to imploding, 15.01 will convert to deflated);
  3202.  
  3203.          If the source archive already  contains one or more files  from
  3204.          the NEW systems (f.i.  3 x stored but  1 x deflated), MTA  will
  3205.          not convert it when ZIP is also the target.
  3206.  
  3207.  Relate: ZIP, PAK, LZH
  3208.  Dest. : ZIP, PAK, LZH
  3209.  
  3210.  
  3211.  ┌─────────────────────────────────────────────────────────────────────┐
  3212.  │ AllDisketteFiles                                                    │
  3213.  └─────────────────────────────────────────────────────────────────────┘
  3214.  Usage : When you  use the  /D command-line  parameter (start   diskette
  3215.          conversion), MTA will only  convert archives on the  diskettes.
  3216.          If you  want to  move the  files to  another diskette (with the
  3217.          MoveToDir option) or you want to format the diskette (with  one
  3218.          of the exits),  you must make  sure that ALL  files are reMOVED
  3219.          from  the  diskette.  These  files  will  not  be converted but
  3220.          (temporary) moved to the same directory as where the  converted
  3221.          files are stored (temporary). You can instruct MTA to move  ALL
  3222.          files from the diskette (and back!) by setting this option.
  3223.  
  3224.          Diskette  conversion  is  not  possible  when  the  OnlyUpgrade
  3225.          option is set !
  3226.  
  3227.  Relate: EXITBeforeFill, EXITAfterFill, MoveToDir
  3228.  Dest. : All
  3229.  
  3230.  
  3231.  ┌─────────────────────────────────────────────────────────────────────┐
  3232.  │ KeepAbnormalExtensions                                              │
  3233.  └─────────────────────────────────────────────────────────────────────┘
  3234.  Usage : Some of  the archives contain a  special extension that is  not
  3235.          common with the archive system. You can receive files with  the
  3236.          extension  .A25,  .SDN  and  so  on.  Normally MTA will convert
  3237.          these archives (unless excluded  by DoNot or the  file-mask) to
  3238.          a  new  archive  with  a  NORMAL  extension  (e.g. ZIP when you
  3239.          convert to ZIP). If you include this option, MTA will keep  the
  3240.          abnormal extension even after the conversion. So A.SDN (in  ZIP
  3241.          format), converted to ARJ, will still be called A.SDN.
  3242.  
  3243.          Only one archive system can not work with abnormal  extensions.
  3244.          DWC can only  work with archives  that end with  .DWC. When you
  3245.          convert A.SDN (in ZIP format) to DWC, the result will be  named
  3246.          A.DWC !
  3247.  
  3248.  Relate: None
  3249.  Dest. : All
  3250.  
  3251.  
  3252.  ┌─────────────────────────────────────────────────────────────────────┐
  3253.  │ ReportSpecialAttributes                                             │
  3254.  └─────────────────────────────────────────────────────────────────────┘
  3255.  Usage : Some archives  can contain files with  abnormal file-attributes
  3256.          like  HIDDEN,  READONLY  and/or  SYSTEM.  If  the decompression
  3257.          program is  able to  decompress these  files in  this way,  you
  3258.          could be in for trouble (though MTA will remove any left  files
  3259.          after the conversion). If you like to, MTA can report  archives
  3260.          that contain such files when you set this option.
  3261.  
  3262.  Relate: None
  3263.  Dest. : All
  3264.  
  3265.  
  3266.  ┌─────────────────────────────────────────────────────────────────────┐
  3267.  │ KeepAV                                                              │
  3268.  └─────────────────────────────────────────────────────────────────────┘
  3269.  Usage : Both ARJ and ZIP can create archives with a special  attribute,
  3270.          called  the  security  envelope/Authentification  Verification.
  3271.          Normally these files are created by the original author of  the
  3272.          program(s) that are included and  the code functions as a  kind
  3273.          of proof that the file  is untouched by others (virus,  patches
  3274.          and so on). One piece of  bad luck is that some BBS's  also use
  3275.          the  AV/Security  Envelope  to  mark  these  files as 'theirs',
  3276.          destroying the original idea behind the AV/SE code.
  3277.  
  3278.          When you  want to  keep files  with a  valid AV/SE  as they are
  3279.          (and you should  do so, certainly  on a BBS),  you must include
  3280.          this option.  If MTA  detects such  an archive  it will  do the
  3281.          following:
  3282.  
  3283.          - Decompress the file
  3284.  
  3285.          - Test for any virus (still)
  3286.  
  3287.          - Perform the exists involved;
  3288.  
  3289.          - Remove all decompressed files;
  3290.  
  3291.          - Include any new files to the original file (only ZIP);
  3292.  
  3293.          - Add comments to the original file (only ZIP);
  3294.  
  3295.          - If the  source is an  SFX, it CAN  be converted to  a non-SFX
  3296.            file of the same system (when you set the SFXFiles option);
  3297.  
  3298.          The  original  archive  is  kept  as  it was. Only some special
  3299.          files could be added and, optionally a comment header (ZIP).
  3300.  
  3301.  Relate: IncludeAVFile
  3302.  Dest. : All
  3303.  
  3304.  
  3305.  ┌─────────────────────────────────────────────────────────────────────┐
  3306.  │ IncludeAVFile [filemask] {AVCode}                                   │
  3307.  └─────────────────────────────────────────────────────────────────────┘
  3308.  Usage : As you have read  in the previous option, there are  situations
  3309.          where the  AV/SE code  has NO  meaning whatsoever.  You can use
  3310.          this option to instruct MTA  WHICH AV/SE files must keep  their
  3311.          code. All  others will  be stripped  EVEN if  the KeepAV option
  3312.          forces MTA not to do so.
  3313.  
  3314.          [filemask]    The parameter must  contain a single   file-mask.
  3315.                        You  can  use  the  normal  DOS  wildcards (?,*).
  3316.                        Also  a  special  wildcard  (=)  can be used. '='
  3317.                        will test  for a  shifting match.  So '=WAR' will
  3318.                        match  tradeWAR.zip  and  also  WARning.ARC.  =FZ
  3319.                        will NOT  match with  nodedifF.Zip. In  this case
  3320.                        you  must  use  =F.Z.   You  must  only include a
  3321.                        file-mask and not a directory and/or drive;
  3322.  
  3323.          {AVCode}      When this  parameter  is  NOT  present, all files
  3324.                        that  match  [filemask]  will  keep their AV-code
  3325.                        (e.g.  they  will  not be converted) if KeepAV is
  3326.                        set. You  can  also  supply  a  valid  AV-code or
  3327.                        AV-code-mask  overhere. In  this  case, all files
  3328.                        that  match  [filemask] AND  that  match {AVCode}
  3329.                        will  keep  their  AV-code (e.g. they will not be
  3330.                        converted)  when  KeepAV  is  set. You can either
  3331.                        supply  a  full  AV-code  overhere (like 0000 for
  3332.                        the  AV-code  that comes with original ARJxxx.EXE
  3333.                        distribution  file  or PKW655 that comes with the
  3334.                        original  PKLTExxx.EXE file)  or a mask. The mask
  3335.                        can  include  2  types of characters.  Either a #
  3336.                        (for numeric  digit)  or @ (for alphabetic digit)
  3337.                        can be  used in combination with real digits. For
  3338.                        example,  P@W###  will  cause  a match for PKW655
  3339.                        but NOT for P1WA11;
  3340.  
  3341.          Most obvious  you would  like to  keep the  AV/E codes for some
  3342.          general  files  like SCAN*.*, CLEAN*.*, 4DOS*.* and so on. Some
  3343.          examples are included in the archive. Some general hits:
  3344.  
  3345.          - When you want to keep all ZIP AV-codes, you can supply
  3346.            IncludeAVFile *.* @@@###
  3347.          - When you want to keep all ARJ AV-codes, you can supply
  3348.            IncludeAVFile *.* ####
  3349.          - Independent of the IncludeAVFile options you MUST set the
  3350.            KeepAV option to actually KEEP the AV-codes (e.g. no con-
  3351.            version of the archive). If there is a matching IncludeAVFile
  3352.            but NO KeepAV option, the archive will still be converted;
  3353.  
  3354.          There can be up to 512 IncludeAVFile options in MTA.CTL !
  3355.  
  3356.  Relate: KeepAV
  3357.  Dest. : All
  3358.  
  3359.  
  3360.  ┌─────────────────────────────────────────────────────────────────────┐
  3361.  │ KeepVolLabel                                                        │
  3362.  └─────────────────────────────────────────────────────────────────────┘
  3363.  Usage : Both ARJ and ZIP can contain (optionally) a volume label.  This
  3364.          is  sometimes  used  for  ARJ/ZIP  files  that are a compressed
  3365.          image of a diskette.
  3366.  
  3367.          MTA uses some  special techniques to  enforce the volume  label
  3368.          inside a  ZIP or  ARJ (if  any). The  technique only works when
  3369.          you have the SubstDrive option set and is as follows:
  3370.  
  3371.          - The current  volume-label of the  substituted drive is  read.
  3372.            This is the same label  as the drive containing the  ORIGINAL
  3373.            directory that is now used  for the substitution (in fact  it
  3374.            IS the volume label of that drive);
  3375.  
  3376.          - The ARJ or  ZIP is read. If  it contains no volume-label,  it
  3377.            will be converted as normal;
  3378.  
  3379.          - If it  contains a volume-label,  MTA will decompress  it with
  3380.            the option to decompress the volume-label as well;
  3381.  
  3382.          - The target system will  be called to compress the  file again
  3383.            (if it supports volume-labels,  those options are also  added
  3384.            by MTA);
  3385.  
  3386. │        - MTA will reset  the volume-label to the original value unless
  3387. │          there was no previous value, in which case MTA will set the
  3388. │          label to MTA TMP LBL;
  3389.  
  3390.  Relate: None
  3391.  Dest. : ZIP, ARJ
  3392.  
  3393.  
  3394.  ┌─────────────────────────────────────────────────────────────────────┐
  3395.  │ SkipBackups                                                         │
  3396.  └─────────────────────────────────────────────────────────────────────┘
  3397.  Usage : Both ARJ and ZOO can contain (optionally) backups. These  files
  3398.          are normally not  decompressed by MTA  and will be  lost unless
  3399.          you have set special options for both ARJ and ZOO.
  3400.  
  3401.          If you want  to keep the  backups, you can  force MTA to  leave
  3402.          this archives as they were. In fact, they are skipped when  you
  3403.          supply this option  ! Normal ARJ/ZOO  files that DON'T  contain
  3404.          backup versions are processed as before.
  3405.  
  3406.  Relate: None
  3407.  Dest. : ZOO, ARJ
  3408.  
  3409.  
  3410.  ┌─────────────────────────────────────────────────────────────────────┐
  3411.  │ OverwriteDuplicates                                                 │
  3412.  └─────────────────────────────────────────────────────────────────────┘
  3413.  Usage : Normally  MTA will never  overwrite any duplicate  file. If you
  3414.          convert A.ZIP  and A.ARJ  to ZOO,  it will  result in A.ZOO and
  3415.          A.ZO1 (the second  archive will be  renamed but will  NOT erase
  3416.          the other). If you  supply the OverwriteDuplicates option,  MTA
  3417.          WILL overwrite any file with the same name.
  3418.  
  3419.  Relate: None
  3420.  Dest. : All
  3421.  
  3422.  
  3423.  ┌─────────────────────────────────────────────────────────────────────┐
  3424.  │ Description                                                         │
  3425.  └─────────────────────────────────────────────────────────────────────┘
  3426.  Usage : Most archivers have the  option to add a description to  one or
  3427.          more (or all)  components inside the  archive. If you  set this
  3428.          option, MTA  will add  options for  the target  to ask for such
  3429.          comments. THIS IS MANUAL WORK,  DON'T USE THIS OPTION WHEN  MTA
  3430.          MUST RUN UNATTENDED !!
  3431.  
  3432.  Relate: Autodescription
  3433.  Dest. : All
  3434.  
  3435.  
  3436.  ┌─────────────────────────────────────────────────────────────────────┐
  3437.  │ Autodescription [path]                                           (*)│
  3438.  └─────────────────────────────────────────────────────────────────────┘
  3439.  Usage : When you want to include a comment header in your target  file,
  3440.          you can use this option to do so (automatically). Those  target
  3441.          systems that  support it,  will be  instructed to  add a common
  3442.          header  to  each  and  every  converted  archive. Currently the
  3443.          comment can be added to ZIP, ZOO, ARJ and PAK files.
  3444.  
  3445.          [path]        This value must point to a valid  drive/directory
  3446.                        and  filename  of  the  file  which  include  the
  3447.                        actual comment.   If no  drive is  supplied,  the
  3448.                        default  one  is   used.   Relative   directories
  3449.                        (..\WRKDIR and such) are  not advised but can  be
  3450.                        used   (the   are   counted   from   the  CURRENT
  3451.                        directory).    The   file   must   be   a  normal
  3452.                        text-file. It can be a ANSI file (not  preferred,
  3453.                        most  archivers   won't  display   ANSI-sequences
  3454.                        unless specifically told, because ANSI  sequences
  3455.                        can  reconfigure  the  key-  board.  You would be
  3456.                        surprises and angry to  see that F3 now  starts a
  3457.                        FORMAT  of  your  hard-disk),  but  a normal pain
  3458.                        ASCII file  is best.  The total  size can  not be
  3459.                        greater than 64000 bytes.
  3460.  
  3461.          The AutoDescription can also be combined with the  CarryComment
  3462.          option (see BBS options) to gain maximum result !
  3463.  
  3464.          MTA uses the quickest  but safest way to  add the comment to  a
  3465.          file. In most cases piping  will be used (PKZIP -z  A <comment)
  3466.          but sometimes special options.
  3467.  
  3468.  Relate: Description
  3469.  Dest. : ARJ, ZIP, ZOO, PAK
  3470.  (*)   : Marked options are also in usage by: MTM
  3471.  
  3472.  
  3473.  3.3.6 Your own (new) compressor
  3474.  ───────────────────────────────────────────────────────────────────────
  3475.  The following  statements can  be used  to define  a compressor that is
  3476.  not (yet)  included in  MTA. If  you find  a compressor  that meets the
  3477.  standard to be included into MTA then please contact the author.
  3478.  
  3479.  Your OWN compression and decompression programs must follow some  basic
  3480.  rules and it is only needed to  include them if they are not yet  added
  3481.  to the STANDARD MTA support. The following rules apply:
  3482.  
  3483.  - They must report an errorlevel higher than 0 if errors occur;
  3484.  
  3485.  - The first errorlevel that reports  an error can not be followed  by a
  3486.    higher errorlevel that does NOT report an error;
  3487.  
  3488.  - The compressor MUST have an  option to delete the files it  has added
  3489.    to the archive;
  3490.  
  3491.  - The decompressor CAN have  recursive support. This also goes  for the
  3492.    compressor. It is not mandatory;
  3493.  
  3494.  - You can NOT use a batch-file to call the compressor/decompressor;
  3495.  
  3496.  - The  compression  system  must  use  its  own  extension (CRA in  the
  3497.    following examples);
  3498.  
  3499.  - Sometimes  you can  use the  support for  OWN compressors to overrule
  3500.    the  normal  compression/decompression  programs  that  MTA  supports
  3501.    internally, but you are on your own;
  3502.  
  3503.  
  3504.  ┌─────────────────────────────────────────────────────────────────────┐
  3505.  │ OwnCompressPath   [path] {opt} {DynSwapSiz} {second path}           │
  3506.  │ OwnDeCompressPath [path] {opt} {DynSwapSiz} {second path}           │
  3507.  └─────────────────────────────────────────────────────────────────────┘
  3508.  Usage : For your own  compression and decompression program, these  two
  3509.          statements must  be included.  The syntax  is the  same as  all
  3510.          other  xxxPath  options.  OwnCompressPath and OwnDecompressPath
  3511.          must point  to the  same file  if compression/decompression  is
  3512.          combined in one program.
  3513.  
  3514.  Relate: All Own-options
  3515.  Dest. : OWN
  3516.  
  3517.  
  3518.  ┌─────────────────────────────────────────────────────────────────────┐
  3519.  │ OwnCompressCall   [parms2use]                                       │
  3520.  │ OwnDeCompressCall [param2use]                                       │
  3521.  └─────────────────────────────────────────────────────────────────────┘
  3522.  Usage : When  using a customized  compression program, you  must supply
  3523.          the  parameters  to  be  passed  to  this program in the option
  3524.          OwnCompressCall.  For  any  decompression,  you must supply the
  3525.          parameters in the OwnDecompressCall option.
  3526.  
  3527.          [parms2use]   This parameter  must be  set in  a way  that  the
  3528.                        following sequence is started for compression:
  3529.  
  3530.                        - Compress all files in the current directory  in
  3531.                          the new archive;
  3532.  
  3533.                        - Delete all files from the current directory  or
  3534.                          compress with a move option (implicit delete);
  3535.  
  3536.                        This  parameter  must  be  set  in a way that the
  3537.                        following sequence is started for decompression:
  3538.  
  3539.                        - DeCompress all  files in the  current directory
  3540.                          from  the  new  archive;  The  name  of the new
  3541.                          archive is included  at the location  where you
  3542.                          add %1 in this parameter.
  3543.  
  3544.  Relate: All Own-options
  3545.  Dest. : OWN
  3546.  
  3547.  
  3548.  ┌─────────────────────────────────────────────────────────────────────┐
  3549.  │ OwnCompressLowErrorRC   [errornumber]                               │
  3550.  │ OwnDecompressLowErrorRC [errornumber]                               │
  3551.  └─────────────────────────────────────────────────────────────────────┘
  3552.  Usage : When  you  include   a  customized (de)compressor, you have  to
  3553.          supply the  LOWEST DOS  errorlevel given  by the (de)compressor
  3554.          when something is WRONG.
  3555.  
  3556.          [errornumber] This  parameter  must  be  the lowest  errorlevel
  3557.                        returned  by  the  (de)compression  program  when
  3558.                        something is wrong. Values must be between 1  and
  3559.                        255;
  3560.  
  3561.  Relate: All Own-options
  3562.  Dest. : OWN
  3563.  
  3564.  
  3565.  ┌─────────────────────────────────────────────────────────────────────┐
  3566.  │ OwnExtension [extension]                                            │
  3567.  └─────────────────────────────────────────────────────────────────────┘
  3568.  Usage : When  you want MTA  to 'see' your  customized compressed files,
  3569.          you have to supply  the name of the  extension MTA has to  look
  3570.          for. This can only be 1 extension (e.g. OWN).
  3571.  
  3572.          [extension]   This parameter must  be the (up to 3 bytes  long)
  3573.                        extension of the compressed files that are  ruled
  3574.                        under the OWN options.
  3575.  
  3576.          For every file that confirms to the supplied file-mask(s),  MTA
  3577.          will FIRST look if it  has an 'OwnExtension'. In that  case MTA
  3578.          will decompress  the file  with the  supplied decompressor.  If
  3579.          the destination is OWN, MTA instruct the customized  compressor
  3580.          to create files with extension 'OwnExtension'.
  3581.  
  3582.  Relate: All Own-options
  3583.  Dest. : All, including source OWN
  3584.  
  3585.  
  3586.  ┌─────────────────────────────────────────────────────────────────────┐
  3587.  │ OwnRecursive                                                        │
  3588.  └─────────────────────────────────────────────────────────────────────┘
  3589.  Usage : When you implement a  compressor, you have to tell MTA  if that
  3590.          compressor  is  capable  of  handling  recursive  support. This
  3591.          means that  the compressor  will look  in the  current and  all
  3592.          lower directories. If the customized compressor can not  handle
  3593.          recursive support, you must leave out this option out.
  3594.  
  3595.  Relate: All Own-options
  3596.  Dest. : OWN
  3597.  
  3598.  
  3599.  3.3.7 Statements that define the various exits (hooks) in MTA
  3600.  ───────────────────────────────────────────────────────────────────────
  3601.  The following statements can be used  to define one or more exits.  The
  3602.  exit points in MTA  can be used to  call other programs, before,  while
  3603.  or after  the compression  and/or start  and end  of MTA.  Some of  the
  3604.  exits like the  VirusScanner option are  advised, the others  are up to
  3605.  you !
  3606.  
  3607.  ┌─────────────────────────────────────────────────────────────────────┐
  3608.  │ VirusScanner [crt] [dynswapsiz] [lowe] {highe} [path] [parm] {parm} │
  3609.  └─────────────────────────────────────────────────────────────────────┘
  3610.  Usage : One of the major topics  on the PC today is the virus.  MTA has
  3611.          specific support for the scan  for a virus. The scanning  (when
  3612.          active) is done  after the decompression  of the files  (before
  3613.          the removal of any files that match any ExcludeFile option).
  3614.  
  3615.          Which scanner(s) you want  to use is fully  up to you. MTA  can
  3616.          support  a  wide  range  of  scanners.  MTA  is tested with the
  3617.          following scanners  (examples for  their calls  are included in
  3618.          the sample MTA.CTL inside the distribution archive):
  3619.  
  3620.          - Scan     by McAfee <tm>
  3621.          - TBScan   by Frans Veldman <tm>
  3622.          - HTScan   by Harry Thijssen <tm>
  3623.          - VIRX     by Microcom Software Division <tm>
  3624.          - CPAV     by Central Point Software <tm> (Version 1.2 and up)
  3625.          - FINDVIRU by S&S International <tm> (Dr. Solomon)
  3626.  
  3627.          With  the  current   version  of  MTA,   up to 10 scanners  can
  3628.          be  included.  If  a  file  contains   a  virus, the archive is
  3629.          moved to  the error-directory  and marked  with special  0-byte
  3630.          files.  Also  further processing of  THIS file   is aborted and
  3631.          MTA will  start working on the next archive.
  3632.  
  3633.          [crt]         You must  either supply   'B' or  'D'. If     the
  3634.                        scanner is BIOS  oriented (line-mode) and  can be
  3635.                        run in the  MTA window, you  can use 'B'.  If the
  3636.                        scanner is using direct video calls/running  full
  3637.                        screen, you  must supply  'D'. MTA  will preserve
  3638.                        the screen according to this option;
  3639.  
  3640.          [dynswapsiz]  This must  be the  amount of  memory (in  Kbytes)
  3641.                        that  must  be  available  to  run  the   scanner
  3642.                        without MTA having to swap itself out of  memory.
  3643.                        The  examples  in  the  supplied MTA.CTL are good
  3644.                        ones and used while testing;
  3645.  
  3646.          [lowe]        This must be the errorlevel the scanner   returns
  3647.                        when  a  virus  is  found.  Most scanners use the
  3648.                        errorlevel 1 when a virus is found, some of  them
  3649.                        use  a  range.  Check  the  documentation  of the
  3650.                        scanner to make sure you supply the right  level.
  3651.                        The  examples  in  MTA.CTL  are  correct  for the
  3652.                        given scanners;
  3653.  
  3654.          {highe}       This parameter is optional. If the scanner   will
  3655.                        return a  range of  errorlevels when  a virus  is
  3656.                        involved  (HTScan  does),  you  must  supply  the
  3657.                        lower limit  in [lowe]  and the  higher limit  in
  3658.                        {highe}.   If you  don't supply  {highe}, it will
  3659.                        be set  to the  same value  as [lowe].  The given
  3660.                        examples  in  MTA.CTL  are  correct for the given
  3661.                        scanners;
  3662.  
  3663.          [Path]        This parameter must contain the drive,  directory
  3664.                        and  filename  of  the  scanner  in question. MTA
  3665.                        will  validate  if  the  program  is at the given
  3666.                        location and give a warning if it isn't;
  3667.  
  3668.          [parm] {parm} At  this  location   you  can  (must) supply  the
  3669.                        various parameters for  the scanner. There  are a
  3670.                        few macros  available  that  will  be replaced by
  3671.                        values at run-time. These are:
  3672.                        %P This macro will be replaced with the full name
  3673.                           of the HIGHEST directory in the tree where the
  3674.                           decompressed files reside;
  3675.                        %F Will do the same but  will  show a \*.* behind
  3676.                           the directory;
  3677.                        %D This macro will be replaced with the LAST node
  3678.                           in the directory  tree.  For  example, if  the
  3679.                           directory is E:\TUP\TST\1F6566A6, %D  will  be
  3680.                           replaced by 1F6566A6. This comes in handy  for
  3681.                           scanners that make problems in networks;
  3682.                        %L This macro will be replaced by the driveletter
  3683.                           and a colon (C:, E: and so on). Some  scanners
  3684.                           can only work on drives and not on directories
  3685.                           only;
  3686.                        %S This is a better replacement for %L.  It  will
  3687.                           be subtituded with the driveletter (and colon)
  3688.                           of the SUBSTituted drive (only  when  you  use
  3689.                           the SUBST support,  which  is  advised).  Only
  3690.                           when the scanner has  problems  with  a  SUBST
  3691.                           drive you should use %L. If you don't use  the
  3692.                           SUBST support of MTA, %S will be replaced with
  3693.                           the normal drive (as with %L);
  3694.  
  3695.          Never forget to  check if the  scanner will halt  for a prompt.
  3696.          If this is the  case and you run  unattended, you could have  a
  3697.          problem. If you  run attended, this  makes no difference.  Most
  3698.          scanners implement  a type  of 'No-prompt'  mode, like /NOPAUSE
  3699.          with SCAN.  Be sure  to set  it somewhere  in [parm] or {parm}.
  3700.          Also do not forget to  implement the option to check  ALL lower
  3701.          trees  under  the  directory  that  is tested. The scanner must
  3702.          also scan all sub-directories.
  3703.  
  3704.          Examples for the mentioned  scanners are included (and  tested)
  3705.          in the example MTA.CTL in the distribution archive.
  3706.  
  3707.  Relate: None
  3708.  Dest. : All
  3709.  
  3710.  
  3711.  ┌─────────────────────────────────────────────────────────────────────┐
  3712.  │ EXITBeforeStart       {dynswapsiz} [path] {option}...{option}       │
  3713.  │ EXITBeforeEnd         {dynswapsiz} [path] {option}...{option}       │
  3714.  │ EXITBetweenConversion {dynswapsiz} [path] {option}...{option}       │
  3715.  │ EXITAfterCompression  {dynswapsiz} [path] {option}...{option}       │
  3716.  │ EXITBeforeFill        {dynswapsiz} [path] {option}...{option}       │
  3717.  │ EXITAfterFill         {dynswapsiz} [path] {option}...{option}       │
  3718.  └─────────────────────────────────────────────────────────────────────┘
  3719.  Usage : These options  include the  support for  various user exits  at
  3720.          various  places  in  MTA.  You   can  instruct  MTA  to call  a
  3721.          program OR a batch-file  (normally batch-files are not  allowed
  3722.          but  they  are  for   these  exits).   All  options  have these
  3723.          parameters in common:
  3724.  
  3725.          {dynswapsiz]} This  can  be  the  amount of memory (in  Kbytes)
  3726.                        that  must  be  available  to  run  the   scanner
  3727.                        without MTA having to swap itself out of  memory.
  3728.                        You  can  also  leave   out  the  parameter   (no
  3729.                        swapping);
  3730.  
  3731.          [Path]        This parameter must contain the drive,  directory
  3732.                        and filename  of the  exit in  question. MTA will
  3733.                        not validate  if they  are present  but will fail
  3734.                        the exit (but continue) if they are not. You  can
  3735.                        either supply a program or a batch-file.
  3736.  
  3737.          {option}      You can include various parameters that  will  be
  3738.                        passed  to  the  called  program/batch over here.
  3739.                        For some  options there  are special  macros (see
  3740.                        below) that can be used.
  3741.  
  3742.          Some of the exits can  contain macros inside the {option}  part
  3743.          of the call, these are:
  3744.  
  3745.          %1   This parameter can  occur anywhere in  {option}. MTA  will
  3746.               substitute  this  parameter  with  the relative path where
  3747.               the  uncompressed  files  are.  This  parameter is in fact
  3748.               superfluous, because  you ARE  in this  directory when the
  3749.               call  to   the  exit   is  made   (only  valid   for   the
  3750.               ExitBetweenConversion and ExitAfterCompression exits);
  3751.  
  3752.          %2   MTA will substitute this parameter with the name (not  the
  3753.               extension) of  the compressed  file (to  be) created (only
  3754.               valid     for      the      ExitBetweenConversion      and
  3755.               ExitAfterCompression exits);
  3756.  
  3757.          %3   MTA will  substitute this  parameter with  the   extension
  3758.               (without  the  point,  so  LZH   and  not  .LZH)  of   the
  3759.               compressed file (to be) created.  Can be used to test  the
  3760.               target  type  in  most  situations  (only  valid  for  the
  3761.               ExitBetweenConversion and ExitAfterCompression exits);
  3762.  
  3763.          %T   MTA will substitute this parameter with the number of  the
  3764.               MTA-task (see  /TASK) that  is running.  When no  /TASK is
  3765.               supplied, %T  will be  replaced by  1. This  macro can  be
  3766.               used to assign different exits for different tasks;
  3767.  
  3768.          You can take  a look into  the supplied example  of batch-files
  3769.          that are present inside the distribution archive.
  3770.  
  3771.          The various exits are called in the following phases:
  3772.  
  3773.          ExitBeforeStart              Called once, after reading     the
  3774.                                       MTA.CTL   file   and   before  the
  3775.                                       actual conversion. Can be used  to
  3776.                                       (re)set the cache  (if any) or  to
  3777.                                       sort directories and so on;
  3778.  
  3779.          ExitBeforeEnd                Called once, after the  conversion
  3780.                                       and  just  before  the termination
  3781.                                       of  MTA.  Can  be  used to reverse
  3782.                                       the actions in ExitBeforeStart  or
  3783.                                       anything else;
  3784.  
  3785.          ExitBetweenConversion        Called after every decompress  and
  3786.                                       before the  actual compress  takes
  3787.                                       place.  Can  be  used  to  perform
  3788.                                       special     actions     on     the
  3789.                                       decompressed files that MTA  can't
  3790.                                       do for you;
  3791.  
  3792.          ExitAfterCompression         Called after every final  compress
  3793.                                       of a file. Can be used to  perform
  3794.                                       actions  on  the  new archive that
  3795.                                       MTA can't do;
  3796.  
  3797.          ExitBeforeFill               Only called when /D is used.   Can
  3798.                                       be used to  do something with  the
  3799.                                       empty  diskette  that  is going to
  3800.                                       be filled  with files.  An example
  3801.                                       is to (re)format such a  diskette.
  3802.                                       Exit   is    called   for    every
  3803.                                       converted diskette;
  3804.  
  3805.          ExitAfterFill                Only called when /D is used.   Can
  3806.                                       be used to  do something with  the
  3807.                                       newly filled diskette. An  example
  3808.                                       is to catalogue  all files on  the
  3809.                                       diskette   with   your    favorite
  3810.                                       catalogue program. Exit is  called
  3811.                                       for every converted diskette;
  3812.  
  3813.          As said before, there  are some example batch-files  inside the
  3814.          distribution archive.
  3815.  
  3816.  Relate: All of MTA
  3817.  Dest. : Any
  3818.  
  3819.  
  3820.  
  3821.  3.3.8 Statements that are useful to Bulletin Board Systems and SysOps
  3822.  ───────────────────────────────────────────────────────────────────────
  3823.  MTA can  be useful  for normal  user and  also for  SysOp's of Bulletin
  3824.  Board Systems (BBS). There are  several options that involve the  daily
  3825.  operation of archives inside a BBS.
  3826.  
  3827.  ┌─────────────────────────────────────────────────────────────────────┐
  3828.  │ QBBSPaths [areafile]                                                │
  3829.  └─────────────────────────────────────────────────────────────────────┘
  3830.  Usage : If you change your file  areas once in a while, you can  decide
  3831.          to  use  another  source  for   MTA  than  the  usage  of   the
  3832.          DefaultPath option. If you  use the QBBSPaths option,  MTA will
  3833.          start the  conversion on  all directories  inside the area-file
  3834.          that you  assign. This  is only  useful when  you make usage of
  3835.          AMS  (the  MarkString/NoMarked  options)  or  the  OnlyNewFiles
  3836.          option.  The  QBBSPaths  option  is  meant for generic QuickBBS
  3837.          <tm> systems.
  3838.  
  3839.          [areafile]    This parameter must contain the drive,  directory
  3840.                        and  filename  of  the  QBBS  areafile.  MTA will
  3841.                        validate if it is  present. The file must  follow
  3842.                        the  standard  (transparent)  FLSEARCH.BBS   file
  3843.                        format;
  3844.  
  3845.          MTA will work on ALL areas  that are supplied in this file.  If
  3846.          you  want  some  extra  areas,  then add some extra DefaultPath
  3847.          options to MTA.CTL. All  directories from the DefaultPath,  the
  3848.          QBBSPaths and the RAPaths options are merged together when they
  3849.          are supplied.
  3850.  
  3851.  Relate: DefaultPath, RAPaths
  3852.  Dest. : All
  3853.  
  3854.  
  3855.  ┌─────────────────────────────────────────────────────────────────────┐
  3856.  │ RAPaths [areafile] {RAver}                                          │
  3857.  └─────────────────────────────────────────────────────────────────────┘
  3858.  Usage : If you change your file  areas once in a while, you can  decide
  3859.          to  use  another  source  for   MTA  than  the  usage  of   the
  3860.          DefaultPath option.  If you  use the  RAPaths option,  MTA will
  3861.          start the  conversion on  all directories  inside the area-file
  3862.          that you  assign. This  is only  useful when  you make usage of
  3863.          AMS  (the  MarkString/NoMarked  options)  or  the  OnlyNewFiles
  3864.          option.  The  RAPaths  option  is  meant for Remote Access <tm>
  3865.          systems.
  3866.  
  3867.          [areafile]    This parameter must contain the drive,  directory
  3868.                        and  filename  of  the  RA  areafile.  MTA   will
  3869.                        validate if it is  present. The file must  follow
  3870.                        the standard (transparent) FILES.RA file format;
  3871.  
  3872.          {RAVer}       There are several formats of the FILES.Ra   file,
  3873.                        depending on  the version  of Remote  Access <tm>
  3874.                        you use. If you  do not supply this  parameter, a
  3875.                        RA 1.xx is assumed.  If you run an  older version
  3876.                        of  RA,  you  must  supply  a '0' over. The other
  3877.                        value you  can supply  ('1') is  the same  as the
  3878.                        default;
  3879.  
  3880.          MTA will work on ALL areas  that are supplied in this file.  If
  3881.          you  want  some  extra  areas,  then add some extra DefaultPath
  3882.          options to MTA.CTL. All  directories from the DefaultPath,  the
  3883.          QBBSPaths  and  the  RAPaths  options  are merged together when
  3884.          they are supplied.
  3885.  
  3886.  Relate: DefaultPath, QBBSPaths
  3887.  Dest. : All
  3888.  
  3889.  
  3890.  ┌─────────────────────────────────────────────────────────────────────┐
  3891.  │ CarryComment [type] {comment}                                       │
  3892.  └─────────────────────────────────────────────────────────────────────┘
  3893.  Usage : This option is  another way of putting (useful)  comment inside
  3894.          the  target  archives.  There  are  various  in  which way this
  3895.          option can work, but only one is allowed. You can overrule  the
  3896.          type of work with the /CARCOM command-line option though.
  3897.  
  3898.          With CarryComment you order MTA to carry over any comment  from
  3899.          the source  archive (PAK/ZIP/ARJ/ZOO)  into the  target archive
  3900.          (same types). The carry can be done in three different ways.
  3901.  
  3902.          [type]        This  parameter can be set to 1, 2 or 3.  The way
  3903.                        CarryComment will work depends on the number  you
  3904.                        set  over  here.  The  values  have the following
  3905.                        meaning:
  3906.  
  3907.                        1 : MTA  will carry over  the comment (up  to 256
  3908.                            bytes) from the source file, if a comment  is
  3909.                            available;
  3910.  
  3911.                        2 : MTA will first look into the source file  and
  3912.                            will remember up to 256 bytes of the  comment
  3913.                            (if any).   After conversion,  MTA will  look
  3914.                            into the  file you  supplied in  the FilesBBS
  3915.                            option (if  you did  supply this  option). If
  3916.                            the file  has a  record inside  the FILES.BBS
  3917.                            (or alike  file), THIS  comment is  taken and
  3918.                            not the comment  in the source  file.  If  no
  3919.                            comment  is  available,  MTA  will  use   the
  3920.                            comment from the source file (if any);
  3921.  
  3922.                        3 : MTA will  always look into the  FILES.BBS (or
  3923.                            alike) file. This is only valid when you  use
  3924.                            the  FilesBBS   option.  If   a  record    is
  3925.                            available,  the  comment  is  carried over to
  3926.                            the target  file. If  no record  is available
  3927.                            the target will NOT have any comment;
  3928.  
  3929.          {comment}     When you supply this  parameter (spaces must   be
  3930.                        replaced  with  underscore  characters), MTA will
  3931.                        put this  comment IN  FRONT of  the comment  that
  3932.                        came from the carry itself. There will be a  CRLF
  3933.                        between this comment and the following  (carried)
  3934.                        comment.
  3935.  
  3936.          You can make a combination  of the AutoComment and the  current
  3937.          option (CarryComment). In  this case, MTA  will add a  combined
  3938.          into  the  target-file.  In  the  combination, the comment from
  3939.          AutoComment file  comes first  and the  comment constructed  by
  3940.          the  CarryComment  statement  comes  directly  (WITHOUT A CRLF)
  3941.          after this comment. Please keep  in mind that you separate  the
  3942.          two comments yourself (if needed) by adding a CRLF in the  file
  3943.          assigned by AutoComment.
  3944.  
  3945.          Please  also  read  the  info  on  the  FilesBBS option and the
  3946.          AddFilesBBS option.
  3947.  
  3948.  Relate: FilesBBS, AddFilesBBS
  3949.  Source: ZIP/PAK/ZOO/ARJ
  3950.  Dest. : ZIP/PAK/ZOO/ARJ
  3951.  
  3952.  
  3953. │┌─────────────────────────────────────────────────────────────────────┐
  3954. ││ FILEIDDIZ {name}                                                    │
  3955. │└─────────────────────────────────────────────────────────────────────┘
  3956. │Usage : For  some  BBS   programs,  the file FILE_ID.DIZ has a  special
  3957. │        meaning.  It  contains  a  description  of the programs (files)
  3958. │        that are included inside the  archive. MTA can do a  few things
  3959. │        with  this  comment.  If  you  use this option (FILEIDDIZ), you
  3960. │        instruct MTA to  store the text  from FILE_ID.DIZ into  memory.
  3961. │        This  is  only  done  when  the  archive  actually  contains  a
  3962. │        FILE_ID.DIZ file (or name-like, see parameters). MTA will  also
  3963. │        check if this  file has the  correct format. If  it hasn't, MTA
  3964. │        will store as much information from this file as is possible.
  3965. │
  3966. │        {name}        Normally MTA will  look for files with the   name
  3967. │                      FILE_ID.DIZ. If this is not the correct  standard
  3968. │                      on your  system, MTA  can look  for another  file
  3969. │                      with the same  format. In that  case you need  to
  3970. │                      supply the name of that file overhere;
  3971. │
  3972. │        This option  (on its  own) will  not do  more than  reading the
  3973. │        file FILE_ID.DIZ  (or the  name you  supplied) and  storing the
  3974. │        information  in  memory.  What  is  going  to  happen with this
  3975. │        informations is  depending on  the FilesBBS/AddFILESBBS  option
  3976. │        and/or the StoreComment option).
  3977. │
  3978. │Relate: FilesBBS/AddFilesBBS, StoreComment
  3979. │Source: All
  3980. │Dest. : All
  3981.  
  3982.  
  3983.  ┌─────────────────────────────────────────────────────────────────────┐
  3984.  │ FilesBBS {location}                                                 │
  3985.  └─────────────────────────────────────────────────────────────────────┘
  3986.  Usage : If you convert files, the name will change in most cases  (from
  3987.          the source system, fi.  A.ZIP, to the destination,  fi. A.LZH).
  3988.          This change will  cause any entry  in the FILES.BBS  alike file
  3989.          to be  invalid. MTA  can help  out in  this case.  When you add
  3990.          this  option,  the  entries  in  the  FILES.BBS  alike file (if
  3991.          available) will also change !
  3992.  
  3993.          There are several  formats of this  option. If coded  without a
  3994.          parameter, MTA will  assume FILES.BBS as  the filename and  the
  3995.          directory where the conversion  takes place as the  location of
  3996.          the file.
  3997.  
  3998.          {location}    This parameter is optional an can either contain:
  3999.  
  4000.                        - A filename. In  this case MTA will  assume this
  4001.                          filename  as  the  name  of the FILES.BBS alike
  4002.                          file  and  the  directory  where the conversion
  4003.                          takes place as the location;
  4004.  
  4005.                        - A  full path,  containing drive,  directory and
  4006.                          filename. In  this case,  MTA will  assume that
  4007.                          you only  have ONE  FILES.BBS alike  file (this
  4008.                          is the case  for RBBS-alike systems).  The name
  4009.                          and location are assigned with this parameter.
  4010.  
  4011.          When you don't use  the FilesBBSFormat option (see  later), MTA
  4012.          will search  for filenames  in position  1 of  each record  and
  4013.          with the format FILENAME.EXT (upper- and lower case).   Changes
  4014.          are  made  after  every  conversion.   If  MTA  aborts  on   an
  4015.          operation,  all  PREVIOUS  archives  that  are  converted   ARE
  4016.          already changed in the FILES.BBS alike file(s).
  4017.  
  4018.          If you run  the ExitAfterCompression to  create SFX files  from
  4019.          the target  archives, the  change in  the FILES.BBS  alike file
  4020.          will  be   incorrect  !   You  must   use  one   of  the    MTA
  4021.          CompressionType values that instruct MTA to create the SFX.  In
  4022.          this case the change will be done correctly !
  4023.  
  4024.          It is also possible to change any sizes in the FILES.BBS  alike
  4025.          file(s). Some  of these  files contain  the actual  size of the
  4026.          file (RBBS master  directory). MTA will  change the size  also,
  4027.          if the correct size was already present in the FILES.BBS  alike
  4028.          file.
  4029.  
  4030.          If comments in the FILES.BBS  alike file start with a  download
  4031.          counter (e.g. FILENAME.EXT [01]  Downloaded once), and you  use
  4032.          the CarryComment  option (types  2 or  3), MTA  will strip  the
  4033.          download-counter  (only  when  the  format  is [nnnn]) from the
  4034.          description  that  will  be  added  to  the archive (not in the
  4035.          FILES.BBS alike file).
  4036.  
  4037.          This option  can also  be used  in a  NON-BBS environment where
  4038.          4Dos is installed and used. You should set the various  options
  4039.          as follows:
  4040.  
  4041.          - Set the FilesBBS option       to 'FilesBBS DESCRIPT.ION';
  4042.          - Set the FilesBBSFormat option to 'FilesBBSFormat 1 1 I2';
  4043.          - Set the AddFilesBBS option;
  4044.          - Set the CarryComment option to 2 (without extra parameters);
  4045.  
  4046.          In this case the comment will  be carried over out of the  4Dos
  4047.          DESCRIPT.ION file (this  is a hidden  file that 4DOS  maintains
  4048.          when you  use the  DESCRIBE command),  the change  of extension
  4049.          (if any) will be performed in the same file and if there is  no
  4050.          comment for this file in  the DESCRIPT.ION file, MTA can  carry
  4051.          over the comment from the archive (if any) into this file.
  4052.  
  4053.          When the FilesBBS option is active and MTA detects a  defective
  4054.          archive, MTA will move  this archive to the  supplied directory
  4055.          for  archives  in  error.  MTA  will also carry the description
  4056.          from the original FILES.BBS alike file over to a new  FILES.BBS
  4057.          alike file in this error directory.  The original comment  will
  4058.          ALSO  stay  in  the  original  FILES.BBS  alike  file. When the
  4059.          FILES.BBS alike  file is  on a  fixed location,  this option is
  4060.          not triggered.
  4061.  
  4062.  Relate: FilesBBSFormat
  4063.  Dest. : All
  4064.  
  4065.  
  4066.  ┌─────────────────────────────────────────────────────────────────────┐
  4067.  │ AddFilesBBS                                                         │
  4068.  └─────────────────────────────────────────────────────────────────────┘
  4069.  Usage : If you receive new  files without any entries in the  FILES.BBS
  4070.          alike file,  MTA can  add them  for you.  If the source archive
  4071.          also contains a  description (comment), this  is also added  to
  4072.          that file. The AddFilesBBS  option will ONLY function  when you
  4073.          have  set  the  FilesBBS  option.  The description will only be
  4074.          added (if present) when the  CarryComment option is set with  a
  4075.          value of 1 or 2. The format of the added record is the same  as
  4076.          set in the FilesBBSFormat option.
  4077.  
  4078.          If you have set the FILEIDDIZ option AND there is such a file
  4079.          inside the archive, MTA will use THIS comment (it has a higher
  4080.          priority than CarryComment) for the new entry in the FILES.BBS
  4081.          alike file. If there already IS a comment in the FILES.BBS
  4082.          alike file (for this file), MTA will NOT overwrite that comment
  4083.          with the new comment.
  4084.  
  4085. │Relate: FilesBBSFormat, FilesBBS, CarryComment, FileIDDiz
  4086.  Dest. : All
  4087.  
  4088.  
  4089.  ┌─────────────────────────────────────────────────────────────────────┐
  4090.  │ FilesBBSFormat [name] [extension] [comment]                         │
  4091.  └─────────────────────────────────────────────────────────────────────┘
  4092.  Usage : This option will instruct MTA about the internal format of  the
  4093.          FILES.BBS alike  file.   Under default  conditions, MTA expects
  4094.          the  filename  to  start  on  position  1  of each line, with a
  4095.          filename format  for name.ext  (with a  point between  the name
  4096.          and the  extension) and  the comment  to start  on position 14.
  4097.          When your FILES.BBS alike file  (if you use any) is  different,
  4098.          you must use this option to set the new format.
  4099.  
  4100.          [name]        This parameter must be set to the position  where
  4101.                        the filename will start;
  4102.  
  4103.          [extension]   This parameter must be set to the position  where
  4104.                        the  extension  will  start.  If filename and the
  4105.                        extension  are  combined  together  with a point,
  4106.                        [name] and [extension] must be the same value;
  4107.  
  4108.          [comment]     This parameter must be the starting point of  the
  4109.                        comment.  If  the  FILES.BBS  alike file does not
  4110.                        contain a comment,  you must set  it to 255.   If
  4111.                        the comment 'floats'  somewhere in the  file, the
  4112.                        starting position  is different  every time,  you
  4113.                        can use another format.  In this case you  supply
  4114.                        the ITEM NUMBER  (and not the  starting position)
  4115.                        with the value 'I'. For example:
  4116.  
  4117.                        My.ZIP 1234 The comment
  4118.                        Our.ZIP 233222 The comment
  4119.  
  4120.                        In  this  case,  the  comment  is floating but is
  4121.                        always the 4th item.  In this case you  supply 4I
  4122.                        for this parameter.
  4123.  
  4124.          The FilesBBSFormat option only has a meaning when the  FilesBBS
  4125.          option is also set.
  4126.  
  4127.  Relate: FilesBBS
  4128.  Dest. : All
  4129.  
  4130.  
  4131.  ┌─────────────────────────────────────────────────────────────────────┐
  4132.  │ TICKFiles [mask]                                                    │
  4133.  │ FESFiles  [mask]                                                    │
  4134.  └─────────────────────────────────────────────────────────────────────┘
  4135.  Usage  :  Until  now,  all  previous  BBS-options had to do with normal
  4136.          FILES.BBS alike type of  files. The following options  do some-
  4137.          thing  with  other  types  of  files.   These  options makes it
  4138.          possible to pick  up the description  of a certain  file from a
  4139.          TICK or  FES file.  When you  get your  files into  the inbound
  4140.          directory and the *.TIC/FES files along with them, you can  now
  4141.          convert them (and  optionally move them)  to any other  system,
  4142.          while MTA will try to extract the comment of the file from  the
  4143.          associated TICK/FES-file. You can  do two types of  things with
  4144.          these  comments.  You  can  add  them  to  the  FILES.BBS   (if
  4145.          AddFILESBBS is set to on) AND you can store them in the  header
  4146.          of the archive (comment) when CarryComment is set to on.
  4147.  
  4148.          If CarryComment is on (independent  of the type 1,2 or  3), MTA
  4149.          will  search  for  the  comment  in the old archive-header, the
  4150.          FILES.BBS or  both. If  TICKFiles is  set   AND MTA  can find a
  4151.          description in any of the TICK-files, this comment will  always
  4152.          overrule the comment from the FILES.BBS or the old header.  The
  4153.          same goes for the FESFiles option.
  4154.  
  4155.          [mask]        This parameter must point to a drive,   directory
  4156.                        and  filemask.   Most  obvious   is  to   include
  4157.                        *.TIC as   the  filemask   (and  in   some  cases
  4158.                        *.BAD can also be handy).
  4159.  
  4160.          You  can  use  multiple  TICKFiles  options to assign different
  4161.          TICK files (*.TIC and *.BAD) and in different directories.   Up
  4162.          to  10  are  allowed.  Also  10  FESFiles  options  are allowed
  4163.          (*.FES, *.BAD).
  4164.  
  4165.          The  TICK/FES-files  are  ALL  searched  (for  every  converted
  4166.          archive) until either:
  4167.  
  4168.          - a description is found;
  4169.  
  4170.          - all files are processed and no description was found;
  4171.  
  4172.          MTA will  search for  either FILE:  or FILE  and DESC: and DESC
  4173.          inside the TICK-files. This is  pointed out in FSC-0028 !   The
  4174.          FES files follow the authors description !
  4175.  
  4176.  Relate: FilesBBS, AddFilesBBS, CarryComment
  4177.  Dest. : All
  4178.  
  4179.  
  4180.  ┌─────────────────────────────────────────────────────────────────────┐
  4181.  │ UpdateUntypedFiles [mask]                                           │
  4182.  └─────────────────────────────────────────────────────────────────────┘
  4183.  Usage : This is  a special, independent, option  to update any type  of
  4184.          file with the new (converted) name of the archive. Let us  take
  4185.          an example:
  4186.  
  4187.          -) Some  products keeps  a small  database with  names of files
  4188.             (also your archives) inside.   RFW is such an example.   Now
  4189.             you  convert  some  archive  and  the information inside the
  4190.             database has  become invalid  !   UpdateUntypedFiles is  the
  4191.             answer to your problem.
  4192.  
  4193.          UpdateUntypedFiles will update ANY type of file (even a
  4194.          program / binary file) with the new name of the archive IF:
  4195.  
  4196.          - You don't use the /D option;
  4197.  
  4198.          - The name  of the target  has the same  length as the  name of
  4199.            the source. A  conversion from something.ZIP  to Something.MD
  4200.            will not be performed;
  4201.  
  4202.          - The name location is  within the 64K (65535) bytes  bounds of
  4203.            the file;  Longer files  will NOT  be truncated  but only the
  4204.            first 64K of bytes are scanned and (optionally) changed;
  4205.  
  4206.          [mask]        This parameter must point to a drive,   directory
  4207.                        and filemask.
  4208.  
  4209.          You can add up to  10 UpdateUntypedFiles options into the  file
  4210.          MTA.CTL. But be smart and think before you do. MTA will  search
  4211.          ALL files and though  this is fast I/O,  it can take some  time
  4212.          if you include numerous files !
  4213.  
  4214.          UpdateUntypedFiles can be used  as a replacement to  the update
  4215.          of the  FILES.BBS alike  file(s) when  these files  are smaller
  4216.          than 64K.  In that  case, this  option will  give you a 50-200%
  4217.          gain in speed over the FilesBBS option !!.
  4218.  
  4219.  Relate: UpdateTICKFiles, UpdateFESFiles
  4220.  Dest. : All
  4221.  
  4222.  
  4223.  ┌─────────────────────────────────────────────────────────────────────┐
  4224.  │ UpdateTICKFiles [mask]                                              │
  4225.  │ UpdateFESFiles  [mask]                                              │
  4226.  └─────────────────────────────────────────────────────────────────────┘
  4227.  Usage : The syntax  is the  same as  with UpdateUntypedfiles.  See  the
  4228.          chapter  about  TICK  files,  later  in this documentation. The
  4229.          material is to complex to put over here.
  4230.  
  4231.  Relate: UpdateUntypedFiles
  4232.  Dest. : All
  4233.  
  4234.  
  4235.  ┌─────────────────────────────────────────────────────────────────────┐
  4236.  │ COMPort [port]                                                      │
  4237.  └─────────────────────────────────────────────────────────────────────┘
  4238.  Usage : MTA has internal modem support. This is needed in case you  run
  4239.          MTA as an exit of the  BBS (e.g. a protocol driver like  DISP's
  4240.          FileDoor). When you  use modem support,  MTA will echo  some of
  4241.          the progress to the COM-port and the user can follow a part  of
  4242.          the  conversion.  All  modem  related  options  will do NOTHING
  4243.          unless the Remote option or the /REMOTE command-line  parameter
  4244.          is used.
  4245.  
  4246.          [port]        This parameter must  point to the COM-port  that
  4247.                        MTA will use. If set to 0, no remote tracking  is
  4248.                        done.
  4249.  
  4250.  Relate: BaudRate, Remote, FossilPort /REMOTE
  4251.  Dest. : All
  4252.  
  4253.  
  4254.  ┌─────────────────────────────────────────────────────────────────────┐
  4255.  │ FOSSILPort [port]                                                   │
  4256.  └─────────────────────────────────────────────────────────────────────┘
  4257.  Usage : This  option  can   be  used  as a replacement for  the COMPort
  4258.          option. The major difference is  that [port] will now point  to
  4259.          the FOSSIL port number (usually 1 less than the COM-port).
  4260.  
  4261.  Relate: BaudRate, Remote, COMPort /REMOTE
  4262.  Dest. : All
  4263.  
  4264.  
  4265.  ┌─────────────────────────────────────────────────────────────────────┐
  4266.  │ BAUDRate [baud]                                                     │
  4267.  └─────────────────────────────────────────────────────────────────────┘
  4268.  Usage : When  remote tracking is  used, MTA must  know the baudrate  of
  4269.          the MTA-to-Modem speed.
  4270.  
  4271.          [baud]        This parameter must be set to the connect  speed.
  4272.                        If you  use a  locked modem,  you must  set it to
  4273.                        the locked  speed and  not to  the connect speed.
  4274.                        If set to 0, remote tracking is disabled.
  4275.  
  4276.          Normally you use  the /BAUD command-line  parameter to set  the
  4277.          baud-rate because it can vary, unless a locked speed is used.
  4278.  
  4279.  Relate: COMPort or FOSSILPort, Remote, /REMOTE
  4280.  Dest. : All
  4281.  
  4282.  
  4283.  ┌─────────────────────────────────────────────────────────────────────┐
  4284. ││ StoreSize {ext}                                                     │
  4285.  └─────────────────────────────────────────────────────────────────────┘
  4286.  Usage : This option, on its   own, does nothing, but it will be  useful
  4287.          when  remote  tracking  is  active.  In  this case it will do a
  4288.          function  that  is  specific  to  FileDoor.  If  this option is
  4289.          active and  MTA is  running under  FileDoor, MTA  will create a
  4290.          special file  with a  specific format.  This file  contains the
  4291.          ACTUAL size of  the file BEFORE  the conversion. FileDoor  will
  4292.          detect this file and will credit the user for the actual  bytes
  4293.          that were uploaded and not  the newly created number of  bytes.
  4294.          For example the user uploads  A.ARC (10000 bytes) and MTA  will
  4295.          convert it to A.ZIP  (6000 bytes). Without StoreSize,  FileDoor
  4296.          will credit  the user  for 6000  bytes but  with StoreSize set,
  4297.          FileDoor will take the actual 10000 bytes as credit.
  4298.  
  4299. │        {ext}  Normally, MTA will create a file with the name equal  to
  4300. │               the archive (without  extension) and the  extension XS1.
  4301. │               This extension can only be used in FileDoor  3.01+.  All
  4302. │               earlier versions (up to 3.01Γ5)  use  the  extension F$D.
  4303. │               When you run FileDoor 2.03 (up to 3.01Γ5) or a  clone of
  4304. │               FileDoor  that  uses this system, you  must change {ext}  to
  4305. │               the proper extension (F$D in case of FileDoor 2.03);
  4306. │
  4307. │        Even if you don't run remote, you can still use this option. In
  4308. │        this case, it is up to you (or a batch oriented program) to  do
  4309. │        something with the created file(s).
  4310.  
  4311.  Relate: Remote
  4312.  Dest. : All
  4313.  
  4314.  
  4315. │┌─────────────────────────────────────────────────────────────────────┐
  4316. ││ StoreName {nam}                                                     │
  4317. │└─────────────────────────────────────────────────────────────────────┘
  4318. │Usage : This option, on its   own, does nothing, but it will be  useful
  4319. │        when  remote  tracking  is  active.  In  this case it will do a
  4320. │        function  that  is  specific  to  FileDoor.  If  this option is
  4321. │        active and  MTA is  running under  FileDoor, MTA  will create a
  4322. │        special file  with a  specific format.  This file  contains the
  4323. │        name of the archives before and after the  conversion. FileDoor
  4324. │        will detect this file and will use it to see any altered  names
  4325. │        AFTER the upload.
  4326. │
  4327. │        {nam}  Normally, MTA will create a file with the name equal  to
  4328. │               FileDoor.XS2. This filename can only be used in FileDoor
  4329. │               versions 3.01 (3.01Γ6 up to release). Only  beta-testers
  4330. │               and users  of FileDoor <tm> clones will  have  to  alter
  4331. │               {name} to something different (FILEDOOR.F#D  for gamma's
  4332. │               up to 3.01Γ5.
  4333. │
  4334. │        Even if you don't run remote, you can still use this option. In
  4335. │        this case, it is up to you (or a batch oriented program) to  do
  4336. │        something with the created file(s).
  4337. │
  4338. │Relate: Remote
  4339. │Dest. : All
  4340. │
  4341. │
  4342. │┌─────────────────────────────────────────────────────────────────────┐
  4343. ││ StoreComment {ext}                                                  │
  4344. │└─────────────────────────────────────────────────────────────────────┘
  4345. │Usage : This option, on its   own, does nothing, but it will be  useful
  4346. │        when  remote  tracking  is  active.  In  this case it will do a
  4347. │        function  that  is  specific  to  FileDoor.  If  this option is
  4348. │        active and  MTA is  running under  FileDoor, MTA  will create a
  4349. │        special file  with a  specific format.  This file  contains the
  4350. │        comment (from CarryComment or FileIDDIZ) for the specific  file
  4351. │        that was uploaded by the user.
  4352. │
  4353. │        {nam}  Normally, MTA will create a file with the name equal  to
  4354. │               FILEDOOR.XS3. This  name can  only be  used in  FileDoor
  4355. │               3.01+ (up from FileDoor 3.01Γ6). If you use  a  FileDoor
  4356. │               clone you will have to  alter {nam}  to  the  name  this
  4357. │               program uses;
  4358. │
  4359. │        Even if you don't run remote, you can still use this option. In
  4360. │        this case, it is up to you (or a batch oriented program) to  do
  4361. │        something with the created file(s).
  4362. │
  4363. │Relate: Remote
  4364. │Dest. : All
  4365.  
  4366.  
  4367.  ┌─────────────────────────────────────────────────────────────────────┐
  4368.  │ Remote                                                              │
  4369.  └─────────────────────────────────────────────────────────────────────┘
  4370.  Usage : When set (and  when both COMPort and Baudrate  contain non-zero
  4371.          values), MTA will do remote tracking and will send messages  to
  4372.          the remote user.
  4373.  
  4374.  Relate: Baudrate,FOSSILPort,COMPort,StoreSize,StoreName,StoreComment
  4375.  Dest. : All
  4376.  
  4377.  
  4378.  ┌─────────────────────────────────────────────────────────────────────┐
  4379.  │ RemoteColor [txtlow] [txthig] [ok] [err] [act] [fil]                │
  4380.  └─────────────────────────────────────────────────────────────────────┘
  4381.  Usage : This  option can be  used to overrule  the default colors  that
  4382.          MTA uses for remote messages.
  4383.  
  4384.          [...]         There are 6 types of colors that can be   changed
  4385.                        to your own  needs. You must  supply ALL of  them
  4386.                        when  you  use  this  option.  [...] can have the
  4387.                        following values:
  4388.  
  4389.                        0  : Black            8  : DarkGray
  4390.                        1  : Blue             9  : LightBlue
  4391.                        2  : Green            10 : LightGreen
  4392.                        3  : Cyan             11 : LightCyan
  4393.                        4  : Red              12 : LightRed
  4394.                        5  : Magenta          13 : LightMagenta
  4395.                        6  : Brown            14 : Yellow
  4396.                        7  : LightGray        15 : White
  4397.  
  4398.                        You must supply  a value that  is made up  by the
  4399.                        foreground-color  and  background-color  with the
  4400.                        following formula:
  4401.  
  4402.                        Color = [Foreground] + 16 * [Background]
  4403.  
  4404.                        Only the values 0 to 7 can be used for the  back-
  4405.                        ground color. Also you  can add 128 to  the total
  4406.                        to force a blinking value !
  4407.  
  4408.                        [txtLow] This  is  the  low intensity text  color
  4409.                                 (common text). Default value is 3;
  4410.  
  4411.                        [txtHig] This  is the  high intensity  text color
  4412.                                 (common text). Default value is 11;
  4413.  
  4414.                        [Ok]     This is  the color to  display  ok-text.
  4415.                                 Default value is 10;
  4416.  
  4417.                        [Err]    This  is the  color to  display  errors.
  4418.                                 Default value is 12;
  4419.  
  4420.                        [Act]    This  is the  color to  display  special
  4421.                                 activity. Default value is 13;
  4422.  
  4423.                        [Fil]    This  is the  color to  display   files.
  4424.                                 Default value is 14;
  4425.  
  4426.          Local colors can  not be changed  (yet). Colors are  only shown
  4427.          when ANSI-support is used (so /ANS0 is not used).
  4428.  
  4429.  Relate: Remote
  4430.  Dest. : All
  4431.  
  4432.  
  4433.  3.3.9 Special statements
  4434.  ───────────────────────────────────────────────────────────────────────
  4435.  The following statements  are a collection  of statements that  can not
  4436.  be categorized in one of the other groups.
  4437.  
  4438.  ┌─────────────────────────────────────────────────────────────────────┐
  4439.  │ IncludeCtl [path]                                                   │
  4440.  └─────────────────────────────────────────────────────────────────────┘
  4441.  Usage : This parameter is optional. In MTA.CTL you can include one  (or
  4442.          several) other CTL-files. This comes in handy when you want  to
  4443.          separate  your  'normal'  run-time  options  and  the 'special'
  4444.          options you change much.
  4445.  
  4446.          MTA  can  handle  nested  IncludeCTL  statements.  So  you  can
  4447.          include 'IncludeCTL MTA.001' in your MTA.CTL and again you  can
  4448.          include  'IncludeCTL  MTA.002'  in  your  MTA.001.   The  total
  4449.          number of IncludeCTL options  (nested and in the  primary file)
  4450.          can be up to 16.
  4451.  
  4452.          [path]        This parameter must  point to the    control-file
  4453.                        you want to  include. The parameter  must contain
  4454.                        the drive, directory and filename.
  4455.  
  4456.  Relate: None
  4457.  Dest. : All
  4458.  
  4459.  
  4460.  3.3.10 Statements available when using a registered version
  4461.  ───────────────────────────────────────────────────────────────────────
  4462.  The following statements can  be used to define  one or more exits.  An
  4463.  exit a sort  of hook in  the MTA execution  process. The several  exits
  4464.  (hooks) are called at special places  while MTA is executing on one  or
  4465.  more files.  The user  can 'hook  into' the  process when  one or  more
  4466.  exits are defined in MTA.CTL.
  4467.  
  4468.  ┌─────────────────────────────────────────────────────────────────────┐
  4469.  │ RegistrationName [name]                                             │
  4470.  └─────────────────────────────────────────────────────────────────────┘
  4471.  Usage : This option  has only a meaning  when you received a  key after
  4472.          you registered MTA.  In ANY OTHER  case (non registered  usage)
  4473.          you must NOT include this option.
  4474.  
  4475.  Relate: None
  4476.  Dest. : All
  4477.  
  4478.  
  4479.  
  4480.  3.4 Diskette option
  4481.  ───────────────────────────────────────────────────────────────────────
  4482.  One of  the benefits  of MTA  is its  power to  convert diskettes  with
  4483.  great ease. This  method is only  functioning properly when  you have a
  4484.  PC with both floppy (FDU) and hard-disk (HDU).
  4485.  
  4486.  Most  users  with  hard-disks  will   have  a  collection  of   archive
  4487.  diskettes,  containing  their  (less)  used  software. When new archive
  4488.  systems are released  (or newer versions),  conversion of the  complete
  4489.  collection is sometimes needed (or wanted).
  4490.  
  4491.  You must activate MTA's diskette option with the /D switch. If you  do,
  4492.  MTA will start a conversion  cycle that can be interrupted  by pressing
  4493.  [ESC] when the next  diskette is finished. It  can be repeated for  the
  4494.  next diskette  when you  insert this  diskette into  the drive and when
  4495.  you press [ENTER].
  4496.  
  4497.  Which steps does MTA take to convert a diskette:
  4498.  
  4499.  - MTA  will read  all files  (the ones  matching the wildcard, normally
  4500.    you use the *.*  wildcard to select them  all) and will detect  which
  4501.    files are archives or not;
  4502.  
  4503.  - MTA will move (copy + delete) the archives to the directory that  you
  4504.    assigned  to  the  FDUTempPath  option.  If  you  also  supplied  the
  4505.    AllDisketteFiles option, MTA will also move all non-archive files  to
  4506.    that directory;
  4507.  
  4508.  - MTA  will convert  all archives  inside the  FDUTempPath directory to
  4509.    the new system or the higher release;
  4510.  
  4511.  - The exit ExitBeforeFill is called,  so you can do something with  the
  4512.    (empty if AllDisketteFiles was set) diskette (like a reformat);
  4513.  
  4514.  - Now  MTA will  sort the  converted (and  non-archive) files  based on
  4515.    size.  It  will  start  a  copy  for  each file, from the FDUTempPath
  4516.    directory (back) to  the diskette until  one of the  following events
  4517.    happens:
  4518.  
  4519.    - The diskette is full before the  last file is copied.  This can  be
  4520.      the  case  when  the  target  system  has  created  bigger files (a
  4521.      negative reduction); - The files are all moved;
  4522.  
  4523.    Depending on the type of event above, MTA will do the following:
  4524.  
  4525.    - When there are still files  left to copy back, MTA will  move these
  4526.      files to the directory you assigned in the FDUTrashPath option;
  4527.  
  4528.    - When all  files were moved  back to the  diskette and the  diskette
  4529.      still contains free space (you  had a positive reduction on  one or
  4530.      more archives), MTA  will look if  there is/are (a)  file(s) in the
  4531.      FDUTrashPath directory  that fit  on the  diskette. If  so, it will
  4532.      copy this(these) file(s) until the diskette is full or until  there
  4533.      are  no  files  left  that  will  fit  into  the  free space on the
  4534.      diskette;
  4535.  
  4536.  - MTA will now execute the ExitAfterFill EXIT if set;
  4537.  
  4538.  - MTA will ask for next diskette (or you press [ESC] to terminate);
  4539.  
  4540.  Please notice  that it  is possible  that MTA  leaves some files inside
  4541.  the FDUTrashPath  directory after  it has  finished. If  the number  of
  4542.  files  is  getting  to  big  (or  there  are  no more diskettes left to
  4543.  convert), insert an empty diskette in  the FDU and run MTA with  the /D
  4544.  option. Because  there are  no files  to convert,  MTA will  move files
  4545.  from the FDUTrashPath directory to this empty diskette. You can  repeat
  4546.  this  until  the  lower  threshold  is  reached  or until all files are
  4547.  moved.
  4548.  
  4549.  One final  word. As  you have  noticed (I  hope) you  can add unlimited
  4550.  power to  MTA's diskette  option with  the 'Before'  and 'After' exits.
  4551.  These  can  be  used  to  reformat  the diskette or something else (the
  4552.  'Before'  exit)  and/or  to  re-catalog  your  diskette  when you use a
  4553.  disk-catalog program (the 'After' exit).
  4554.  
  4555.  
  4556.  
  4557.  3.5 KeyBoard control
  4558.  ───────────────────────────────────────────────────────────────────────
  4559.  When MTA is executing you have control over some keyboard functions.
  4560.  
  4561.  When you  press [ESC]  (escape button),  MTA will  terminate AFTER  the
  4562.  current files is converted. When you  did hit [ESC] but you would  like
  4563.  to continue after all, you can do  so by hitting any other key.   Using
  4564.  the [ESC] key is not available  when you execute MTA with the  diskette
  4565.  option (/D).
  4566.  
  4567.  When you press [S], MTA will  start a DOS-shell, the moment it  is save
  4568.  to do so. This can be anywhere in the conversion phase. MTA will  place
  4569.  you in the  directory you started  MTA from. NEVER  alter files in  the
  4570.  temporary directory MTA  has created if  you do not  know what you  are
  4571.  doing. Also pressing  any other key  after [S], releases  the DOS-shell
  4572.  option as with [ESC].
  4573.  
  4574.  Pressing [T]  will cause  MTA to  toggle the  statistical display  from
  4575.  static  to  dynamic  mode  or  the  other  way around, depending on the
  4576.  default settings  (AltDisplay option).  You can  toggle as  much as you
  4577.  like while MTA is running. If you  run in a special text mode that  has
  4578.  more than  110 characters  for each  line, the  [T] button  is disabled
  4579.  because all possible screens are displayed.
  4580.  
  4581.  
  4582.  
  4583.  3.6 Running multiple copies of MTA at the same time
  4584.  ───────────────────────────────────────────────────────────────────────
  4585.  You ARE able to  execute multiple copies of  MTA at the same  time when
  4586.  you run a network or  a multitasking environment like DesqView  <tm> or
  4587.  MS-Windows <tm>.
  4588.  
  4589.  To  make  it  possible  for  MTA  to  execute concurrent, you take some
  4590.  special actions:
  4591.  
  4592.  - If you use the SubstDrive option, you must make sure you use as  many
  4593.    drive-letters in this option as you are going to run multiple  copies
  4594.    of MTA;
  4595.  
  4596.  - Make  sure  the  LASTDRIVE  option  is set along with the  SubstDrive
  4597.    option;
  4598.  
  4599.  - Make sure  you have SHARE.EXE  loaded in your  machine. Without SHARE
  4600.    MTA will make a mess of things (SURE !);
  4601.  
  4602.  - Make sure  that you run  all the concurrent  copies of MTA,  all with
  4603.    their  own  TASK-number.  You  assign  a  task  number with the /TASK
  4604.    command-line option. If  you forget this,  MTA will crash  because it
  4605.    will try to use the same substituted drive for each different task;
  4606.  
  4607.  After you have setup  MTA in the way  I described above, MTA  will give
  4608.  protection for some resources:
  4609.  
  4610.  - MTA will protect all the files it uses INTERNALLY;
  4611.  
  4612.  - All  log-files  (if  they  are  the  same in all copies of MTA),  all
  4613.    temporary  files,  all  directories  and  all  substituted drives are
  4614.    either unique to the task or SHARE'ed with all other tasks;
  4615.  
  4616.  - All  external files  (like the  FILES.BBS-alike files)  are protected
  4617.    when  they  are  altered.  This  means  that these files are SHARE'ed
  4618.    within the  multiple copies  of MTA  but also  with other  tasks that
  4619.    have SHAREing options like SOME Bulletin Board Systems;
  4620.  
  4621.  - When  two MTA's  want to  access the  same file  at the same time and
  4622.    with different attributes (one WRITE,  one READ for example), one  of
  4623.    the tasks will wait until the  file is released again. To over-  come
  4624.    problems with 'eternal  waits' (called deadlocks)  you can in-  stall
  4625.    an option in MTA.CTL that will manage the maximum time MTA will  wait
  4626.    before aborting. Waiting for allocation  of a file, will also  be the
  4627.    case  with  external  files,  provided  the  'other'  task  has  used
  4628.    SHAREing attributes with the open of that file. If you want to  abort
  4629.    the waiting (and MTA along the way), you can press [CTRL-E]. In  that
  4630.    case the 'deadlock' is released an MTA will abort;
  4631.  
  4632.  Some resources can NOT be protected by MTA:
  4633.  
  4634.  - MTA  will NOT  manage anything  that happens  within the  shell's. So
  4635.    when  the  (de)compressors  run  or  when  you  are within one of the
  4636.    supplied exits,  the called  program has  to manage  the SHAREing  by
  4637.    itself.
  4638.  
  4639.  It is almost stupid to say,  but be sure to convert different  files in
  4640.  each of the copies  of MTA. Letting two  or more copies of  MTA convert
  4641.  the same files, will cause  trouble. Though SHAREing is managed,  there
  4642.  could be  cases where  MTA is  waiting for  a file  (it will do so) and
  4643.  when this MTA gets the 'GO' signal, the file could be gone  (temporary)
  4644.  because one of the other copies of MTA is working on that file.
  4645.  
  4646.  Running  multiple  MTA's   in  a  multitasking   environment  works but
  4647.  there is a  big tradeoff. When  you don't have  enough 'power' on  your
  4648.  machine,  running  two  concurrent   copies  could  take   as  long  as
  4649.  serially running these copies.  (De)compressors  are  in the  habit  to
  4650.  eat lots  of your cycles. The multi-tasker also wants to have a  little
  4651.  snack and all   are eating   more  food   than  the   PC  can   supply,
  4652.  causing  delays,    low performance and   so on.  I  have  tested  with
  4653.  several machines, but you need  at  least a   true 386-25  (or a   very
  4654.  fast  286, like  a 20Mh)  or  higher to get  good results. But  in  the
  4655.  world  where these options  of MTA   are   needed,  machine-power    is
  4656.  usually  available. Also,  when you  run   MTA   concurrent  and    you
  4657.  use   only  the   /SIM   option, performance  is  not  so  very    much
  4658.  affected  because   MTA will only perform  a decompress (usually   this
  4659.  is very   fast).  This is the    case when you  run    MTA as  an  exit
  4660.  under some  BBS program (like FileDoor <tm>).
  4661.  
  4662.  
  4663.  3.7 Compression of single executable files (PKLITE)
  4664.  ───────────────────────────────────────────────────────────────────────
  4665.  With this version  of MTA, you  can also use  MTA to do  conversions of
  4666.  executable files to compressed  (self contained) executable files  with
  4667.  PKLITE. This feature merely comes as a bonus to the program.
  4668.  
  4669.  MTA's main  goal is  to convert  archives from  a certain  system to  a
  4670.  system you  like. The  compression of  EXE/COM files  can be  used as a
  4671.  separate function.
  4672.  
  4673.  Most of the  MTA.CTL statements have  no meaning to  this type of  con-
  4674.  version. You  can setup  MTA to  do nothing  BUT conversion  of COM/EXE
  4675.  files when  you set  the CompressionType  option to  PKLITE or UNPKLITE
  4676.  but in this case you only use around 10% of the programs functions.
  4677.  
  4678.  In most cases you setup  MTA to do a archive-to-archive  conversion and
  4679.  you set CompressionType to the system  you like. If you have setup  MTA
  4680.  like this (along with all possible  options), you can still use MTA  to
  4681.  convert  COM/EXE  files  by  including   /PKLITE  or  /UNPKLITE  as   a
  4682.  command-line parameter when you call  MTA. MTA will ignore all  options
  4683.  that have  nothing to  do with  the conversion  of executable files and
  4684.  will convert COM/EXE files from normal to PKLITE or back.
  4685.  
  4686.  I did not  include LZEXE because  the latest version  I have seen  can,
  4687.  only convert from normal to LZEXE'ed and not back.  There are  programs
  4688.  that can do the reversed (LZEXE'ed to normal) but there are at least  3
  4689.  I have seen and I can not create a protected and generalized  interface
  4690.  to all of them  (also because 2 of  them come as a  shell and not as  a
  4691.  stand-alone program). This does not  mean that MTA is not  LZEXE-aware.
  4692.  When  selecting  files,  MTA  takes  into  account if a COM/EXE file is
  4693.  already compressed with LZEXE (0.90 or 0.91) and will skip the file  in
  4694.  that case. When decompressing,  MTA will only select  PKLITE-compressed
  4695.  COM/EXE files.
  4696.  
  4697.  When  you  run  MTA  without  any  file-mask,  but  WITH the /PKLITE or
  4698.  /UNPKLITE  option  (or  CompressionType  set  to  one  of  both),   the
  4699.  tag-window will also change and  will only display available files  for
  4700.  this type compression.
  4701.  
  4702.  A file is available (and usable by MTA) for PKLITE if:
  4703.  
  4704.  - It is a COM or EXE file;
  4705.  
  4706.  - If it is not compressed with PKLITE, LZEXE 0.90 or LZEXE 0.91;
  4707.  
  4708.  - If  it is  not a  self-extracting archive  (SFX) of  any of the known
  4709.    archive systems;
  4710.  
  4711.  A file is available (and usable by MTA) for UNPKLITE if:
  4712.  
  4713.  - It is a COM or EXE file;
  4714.  
  4715.  - It is compressed with PKLITE;
  4716.  
  4717.  
  4718.  3.8 The MTA tag-window
  4719.  ───────────────────────────────────────────────────────────────────────
  4720.  When you  run MTA  without any  file-masks on  the command-line,  a tag
  4721.  menu is displayed. In this tag-menu  you have the option to tag  inside
  4722.  only ONE directory. A mix of files in several different directories  is
  4723.  impossible then you use the full-screen tag.
  4724.  
  4725.  When the  tag-menu is  displayed, you  CAN switch  to other directories
  4726.  and even to  other drives. If  one or more  of the displayed  drives is
  4727.  not  available  (not  ready,  door  open,  unformatted  disk) it can be
  4728.  selected but the  tag-window will ignore  it after it  has detected any
  4729.  error on that drive. In that case you must select another drive.
  4730.  
  4731.  When you  start MTA  with SFX  support (so  you include self extracting
  4732.  archives), all files  with abnormal extensions  and COM/EXE files  that
  4733.  are  SFX-files,  will  be  included.  The  testing  will  take a while,
  4734.  depending on the speed of the drive and the machine you have.
  4735.  
  4736.  If you start MTA with the PKLITE or UNPKLITE option, all available  AND
  4737.  usable files are  displayed (so only  decompressed executable files  or
  4738.  executable files, compressed with PKLITE).
  4739.  
  4740.  If you start MTA with the GIFLITE option, all available GIF files  that
  4741.  are not  already processed  by GIFLITE  (AND which  are valid  for MTA,
  4742.  based on the MaxGIFDim option) will be shown.
  4743.  
  4744.  If you start MTA with the GIF option, all available GIF files  that are
  4745.  present will be shown (normal AND GIFLITE).
  4746.  
  4747.  If  you  start  MTA  with  the  GIF2JPG option, all available GIF files
  4748.  (again with respect  to the MaxGifDim  option) are displayed.  When you
  4749.  used the JPG2GIF option, MTA will only show (all available) JPG files.
  4750.  
  4751.  
  4752.  
  4753.  3.9 MTA and unattended operations
  4754.  ───────────────────────────────────────────────────────────────────────
  4755.  There are a number of options that influence the way that MTA works  in
  4756.  unattended mode. Most of them you  can find out when the need  is there
  4757.  but some must be pointed out.
  4758.  
  4759.  In most cases  you will do  an unattended MTA  on the same  directories
  4760.  each time over and over. First I must point out the way you must  setup
  4761.  MTA to work in the right directories. This can be done in one of the  3
  4762.  following ways:
  4763.  
  4764.  - Put the  MTA in a  batch-file, change to  the right directory  before
  4765.    you call  MTA and  call MTA  with its  options (see  later). You  can
  4766.    repeat this for every directory. For example:
  4767.  
  4768.    ..
  4769.    ..
  4770.    D:
  4771.    CD \ZIP1
  4772.    MTA [parameters]
  4773.    E:
  4774.    CD \ZIP2
  4775.    MTA [parameters]
  4776.    ..
  4777.    ..
  4778.  
  4779.    To work on \ZIP1 on D: and \ZIP2 on E:;
  4780.  
  4781.  - Make the batch smaller and  use DefaultPath options in MTA.CTL.   You
  4782.    include DefaultPath  D:\ZIP1 and  DefaultPath E:\ZIP2  in MTA.CTL and
  4783.    you can reduce the previous batch to:
  4784.  
  4785.    ..
  4786.    ..
  4787.    MTA [parameters]
  4788.    ..
  4789.    ..
  4790.  
  4791.    To work on those two directories again;
  4792.  
  4793.  - You  would like  to run  MTA on  all your  directories of  a BBS. MTA
  4794.    supports both QuickBBS  <tm> and Remote  Access <tm> BBS  types.  You
  4795.    include either the  QBBSPaths option or  the RAPaths option.   Inside
  4796.    the batch you do:
  4797.  
  4798.    ..
  4799.    ..
  4800.    MTA [parameters]
  4801.    ..
  4802.    ..
  4803.  
  4804.    And MTA will work on all files in all BBS directories.
  4805.  
  4806.  Now the next problem. You must tel  MTA to work on some files. You  can
  4807.  do this in two different ways:
  4808.  
  4809.  - Use file-masks for [parameters].  In the previous examples you  could
  4810.    tell MTA to convert  all *.ZIP and *.LZH  files (ARJ is your  target)
  4811.    with  'MTA  *.ZIP  *.LZH'  and  MTA  will convert all *.ZIP and *.LZH
  4812.    files in the supplied directories;
  4813.  
  4814.  - Use  the MarkString  and NoMarked  options (or  /MAS and  /MAR on the
  4815.    command-line).  This is a better option. In the previous example  you
  4816.    would have  problems when  someone uploaded  a *.LZS  or *.ARC  file.
  4817.    These would  not be  converted. If  you used  *.* ALL  files would be
  4818.    converted   even    those   that    you   converted    earlier    !!!
  4819.    NoMarked can be used to tell  MTA only to convert files that  confirm
  4820.    to the supplied mask AND that  are not converted before. So with  the
  4821.    NoMarked and MarkString options set,  the call to MTA can  be changed
  4822.    to 'MTA  *.*'. Only  those files  that are  not converted  before are
  4823.    converted and will not be converted again until you set the  NoMarked
  4824.    option to OFF;
  4825.  
  4826.  - Use the OnlyNewFiles option (see the description of this option);
  4827.  
  4828.  Finally there are  some options that  you must change  or include. When
  4829.  you run MTA  in unattended mode  but you don't  want MTA to  run longer
  4830.  than a  certain amount  of time  (BBS events  !!) you  can include  the
  4831.  RunTime option to limit the number of minutes that MTA can run.
  4832.  
  4833.  Remember that MTA  will start in  a new archive  even when 1  second is
  4834.  left, so  you can  outrun the  RunTime by  the time  that your  machine
  4835.  needs to convert the last archive.
  4836.  
  4837.  Sometimes you can  get frequent warnings  on some files.  In unattended
  4838.  mode these  warnings won't  be seen,  neither do  you want  to hear the
  4839.  beeping, so put a value of  0 to the WarningTime option. All  important
  4840.  things are logged (when you put  on the logging). You can also  use the
  4841.  NoBeep option to  make the execution  of MTA more  quiet. When you  run
  4842.  MTA  as  an  exit  under  a  door  (FileDoor <tm>), you should keep the
  4843.  WarningTime option (set to 1 or  higher) and you should use the  NoBeep
  4844.  option. If you set  Warningtime to 0 in  this case, the user  won't see
  4845.  any error messages !
  4846.  
  4847.  REMEMBER. ALWAYS include  a file-mask. To  call MTA without  parameters
  4848.  in unattended mode will force MTA  to display the tag-menu and to  wait
  4849.  until you enter the files.
  4850.  
  4851.  
  4852.  
  4853.  3.10 TICK files and related material
  4854.  ───────────────────────────────────────────────────────────────────────
  4855.  As you know by now, there are several options that deal with TICK  (and
  4856.  its  clone  FES)  files.  I  won't  go  into the TICKFILES option. This
  4857.  option is described in detail in the CTL-section and is only  important
  4858.  with incoming files.
  4859.  
  4860.  It  becomes  different  with  TICK/FES  files  that  are  outbound ! In
  4861.  general you  have the  following problems  when you  run MTA over files
  4862.  that are also the subject of an outgoing TICK/FES file:
  4863.  
  4864.  - The messages that are generated by TICK and FES, contain the name  of
  4865.    the archive. With a conversion from  ARC to ZIP, this will cause  the
  4866.    file to be renamed from A.ARC  to A.ZIP but the messages genera-  ted
  4867.    by TICK/FES still contain A.ARC !
  4868.  
  4869.  - The TICK/FES files  ALSO contain the name  A.ARC, so that is  another
  4870.    problem;
  4871.  
  4872.  - The TICK/FES files also contain  the CRC of the A.ARC file.  Obvious,
  4873.    when you convert  A.ARC to A.ZIP,  the CRC will  also be changed  but
  4874.    the TICK/FES files still contain the old CRC;
  4875.  
  4876.  MTA  can  deal  with  all  these  problems.  You  must  use a number of
  4877.  special options to  do so  (using  them  will cause  some overhead   on
  4878.  MTA)  but after implementing them,  you won't  have any trouble  with a
  4879.  conversion of  a file  that   is also  subject of   a TICK/FES file. In
  4880.  general, these options can also deal with other products than  TICK/FES
  4881.  if they  work in the same way.
  4882.  
  4883.  The following options must be set and will do the following:
  4884.  
  4885.  - UpdateTICKFiles and/or UpdateFESFiles
  4886.    You can add up  to 10 of EACH  options all pointing to  file-masks in
  4887.    certain directories. When you have set  up the BBS is a way  that you
  4888.    support different  TICK/FES outbound  directories for  different nets
  4889.    (or zones), you must point to all of them, for example:
  4890.  
  4891.    UpDateTickFiles D:\MAILER\OUTBOUND\TICZONE1\*.TIC
  4892.    UpDateFESFiles  D:\MAILER\OUTBOUND\TICZONE1\*.FES
  4893.    UpDateTickFiles D:\MAILER\OUTBOUND\TICZONE2\*.TIC
  4894.    UpDateTickFiles D:\MAILER\OUTBOUND\TICZONE5\*.TIC
  4895.  
  4896.    When A.ARC is  converted  to  A.ZIP, MTA will   scan ALL these  files
  4897.    in the  supplied directories  and search   for hits  for A.ARC.  When
  4898.    found, A.ARC  is changed  in A.ZIP.   The TICK/FES  files are changed
  4899.    as binary  files. MTA  reads up  to 16K  of data  per file and does a
  4900.    search  on   the  changed  item.  As  a   result  of this, it  is NOT
  4901.    possible  to   use  these  options  when  the   file-name  length  is
  4902.    changed. So  a   conversion from  A.MD to  A.ARC and  reversed is NOT
  4903.    supported. The changed  files  don't  have  to   be  TICK/FES   files
  4904.    but  these  files contain the filename (obvious).  If  your   product
  4905.    also  creates  a  file  with a filename inside, MTA can still  do the
  4906.    job !
  4907.  
  4908.  - UpdateUntypedFiles
  4909.    You can add up to 10 of these options. In our TICK/FES example,  this
  4910.    option must point to the  netmail directory (outbound) be- cause  the
  4911.    *.MSG files must also be changed. For example:
  4912.  
  4913.    UpDateUntypedFiles D:\MAILER\OUTBOUND\TICZONE1\*.MSG
  4914.    UpDateUntypedFiles D:\MAILER\OUTBOUND\TICZONE2\*.MSG
  4915.    UpDateUntypedFiles D:\MAILER\OUTBOUND\TICZONE5\*.MSG
  4916.  
  4917.    MTA will do the same with these files (obvious they are the  outbound
  4918.    messages). This option differs from  the previous 2 in the  fact that
  4919.    UpdateTICKFiles and UpdateFESFiles ALSO  change the CRC (32-bit  CRC)
  4920.    of the files and this option ONLY the file names;
  4921.  
  4922.  DON'T   use   this   options   when   you   don't  work with a TICK/FES
  4923.  alike  complex.    When   UpdateTICKFiles      and/or    UpdateFESFiles
  4924.  options    are present  in   MTA.CTL, MTA   will ALWAYS   calculate the
  4925.  32-bit CRC of the  source  and   the  target.   This  causes   overhead
  4926.  when there are never updates for  TICK or  FES files.  The 32-bit   CRC
  4927.  is  fast but on a big number of  files  it will still  count ! If   you
  4928.  have TICK  or FES files that  are BIGGER than 16K, please  contact  me.
  4929.  I can change MTA   to make it compatible with  files up to 64K, but  it
  4930.  will cause memory  overhead.   Only when  your seen-by   lines are   to
  4931.  many  to mention, these problems will occur !
  4932.  
  4933.  
  4934.  
  4935.  3.11 FES, yet another TICK-clone ?
  4936.  ───────────────────────────────────────────────────────────────────────
  4937.  By now you will  have seen the   word FES  several  times. In zone   2,
  4938.  net 24x, most  of the  people know  FES. FES  looks like  a  TICK-clone
  4939.  but  implements  some  nice  features   (including  its  own  type   of
  4940.  communication files,  called  *.FES)  that  are  not  found  in   TICK.
  4941.  FES  is   already  released    but   development    goes    on.    Most
  4942.  eye-catching   is the  HATCH procedure  that gives  you a user-friendly
  4943.  interface between your   files, FILES.BBS (in  AND out) and   yourself.
  4944.  FES can optionally create  FES or TICK files for a given node.
  4945.  
  4946.  If TICK is  all you want,  stay with   TICK or take  a peek at  FES. If
  4947.  you are doing distribution yourself  (so adding new files to  a chain),
  4948.  like I do,  FES could  be it.   Also, if  you have  nodes that  want  a
  4949.  large number  of files   from certain  area's,   FES can  also  come in
  4950.  handy  and there is even a FESFix option to obtain files from remote.
  4951.  
  4952.  FES can be  obtained from several  german BBS's and  the author can  be
  4953.  contacted thru FidoNet.
  4954.  
  4955.  
  4956.  
  4957.  3.12 Special ARC considerations
  4958.  ───────────────────────────────────────────────────────────────────────
  4959.  There  are   a  few   special  ARC-files.   These  are   the files that
  4960.  are normally created with a clone of ARC or with ARC 7.xx (or  whatever
  4961.  SEA likes  to  call  it).  In  MOST  cases,  these  archives  can   not
  4962.  be decompressed   with  ARC,   PAK  or   PKUNPAK  but   need a  special
  4963.  kind of program.
  4964.  
  4965.  So far  I   have NO  information   about SEA's  new   archiver and that
  4966.  will stay  that  way   unless  either  SEA   or  someone else can  give
  4967.  me full details  about  the   operation  of  this  program. Until  that
  4968.  time, SEA  eXtended   (7.xx)   archives   will   NOT   be  supported as
  4969.  OUTPUT (target) files.
  4970.  
  4971.  There  ARE  is  a   special  program  that  is   able  to EXTRACT these
  4972.  special type of   archives. It   is called   XARC.EXE and   is released
  4973.  by SEA  for PD/Shareware  (??) usage.  XARC   must be  executed without
  4974.  any parameters and  is therefore not  suitable to be  included in MTA's
  4975.  ARCPath option !
  4976.  
  4977.  The same  story goes  for some   very old  types of  archives that  are
  4978.  more or  less compatible  to the  older   ARC. An  example is the older
  4979.  ARCA and its counterpart  ARCE but  these files  will, in  general,  be
  4980.  available for decompress with ARC, PAK or PKUNPAK.
  4981.  
  4982.  From  my  point  of  view,  it  is  very difficult to support all these
  4983.  non-standard formats.   But to make  it more flexible,  I have included
  4984.  ONE options  that makes  it possible  to use  a special  un-arc program
  4985.  that will be used  for all ARC-alike archives.   You could even call  a
  4986.  special  shell  program  that  can  see  the  difference  between   all
  4987.  ARC-formats  (I  do  NOT  mean  the  difference  between  ARC,  PAK and
  4988.  PKUNPAK, MTA  can see  this for  itself) and  calls the  correct un-ARC
  4989.  procedure for  the supplied  archives.   This option  is the  UNARCPath
  4990.  option.   The program  that is  supplied in  this option  will ONLY  be
  4991.  called   for    DECOMPRESSION   and    is   called    as    PROGRAM.EXT
  4992.  DRIVE:\PATH\ARCHIVEN.AME  (no  options,  only   the  archive  and   its
  4993.  location is presented in the call).
  4994.  
  4995.  The  UNARCPATH  option  is  designed  to  be used with XARC.EXE or with
  4996.  ARCE.EXE/ARCE.COM when you don't expect eXtended SEA archives !
  4997.  
  4998.  If you include the following:
  4999.  
  5000.  ARCPATH   C:\ARC\ARC.EXE  [rest of MTA-parameters]
  5001.  UNARCPATH C:\ARC\XARC.EXE [rest of MTA-parameters]
  5002.  
  5003.  The following will happen  when MTA is called  to convert A.ARC to  the
  5004.  ARC format:
  5005.  
  5006.  - XARC.EXE (or its substitute) is called for decompress;
  5007.  - ARC.EXE  (or its substitute) is called for compress;
  5008.  
  5009.  The following will happen  when MTA is called  to convert A.ARC to  the
  5010.  ZIP (or any NON-ARC) format:
  5011.  
  5012.  - XARC.EXE  (or its substitute) is called for decompress;
  5013.  - PKZIP.EXE (or its substitute) is called for compress;
  5014.  
  5015.  Now the same  sequences without UNARCPath  set and without  XARC.EXE in
  5016.  your DOS-path:
  5017.  
  5018.  - ARC.EXE  (or its substitute) is called for decompress;
  5019.  - ARC.EXE  (or its substitute) is called for compress;
  5020.  
  5021.  and
  5022.  
  5023.  - ARC.EXE   (or its substitute) is called for decompress;
  5024.  - PKZIP.EXE (or its substitute) is called for compress;
  5025.  
  5026.  The latter can  result in errors  when A.ARC is  a SEA eXtended  (7.xx)
  5027.  archive. The first examples will run fine !
  5028.  
  5029.  If you think this is all, then read on. It will become rather messy.
  5030.  In their development, NoGate (PAK) and SEA (ARC) have both found it
  5031.  the correct procedure to keep the internal archive format the same
  5032.  (understandable, you will be backward compatible), but they both use
  5033.  the archive version-number 10 (and maybe higher on SEA's format, but
  5034.  information is not available to me) for their extended format. In the
  5035.  NoGate version, 10 is crushed, in the SEA format, 10 is something else
  5036.  (eXtended in any case because XARC can decompress it). Now see what
  5037.  happens with A.ARC (an eXtended archive, containing 10 files, created
  5038.  with ARC 7.xx):
  5039.  
  5040.  - A.ARC contains 10 files all with code 10;
  5041.  
  5042.  - Code 10 is PAK crushed;
  5043.  
  5044.  - PAK.EXE with extract is called to decompress the archive;
  5045.  
  5046.  - The  result is  an archive  in error  and not  converted because  PAK
  5047.    terminates with error 'CRC error in data' or something else;
  5048.  
  5049.  Nothing can keep me from thinking that the same COULD also be the  case
  5050.  for code 11 (NoGate destilled, SEA  whatever) or even higher !   In any
  5051.  case it is a complete mess and  about 10K of coding in MTA is  consumed
  5052.  by these  little jokes.  The actual  victims are  the users who receive
  5053.  ARC 7.xx files AND PAK files.  Our dear friends in the SDN/SDS  circuit
  5054.  to name but a few !
  5055.  
  5056.  MTA fixes the problem with the ARC-version 10 and 11 with a rather  Q&D
  5057.  solution.  When  PAKPath  AND  UNARCPath  are available in MTA.CTL, MTA
  5058.  will  first  call  PAK  with  the  T  (test)  option.  If the resulting
  5059.  errorlevel is  not 0,  MTA will  use the  program you  supplied in  the
  5060.  UNARCPath option  (e.g. XARC.EXE).  If the  resulting errorlevel equals
  5061.  0, MTA will use  the program you supplied  in the PAKPath option  (e.g.
  5062.  PAK.EXE).
  5063.  
  5064.  When the PAKPAth option is NOT available and PAK.EXE is not in the  DOS
  5065.  path but A.ARC  contains files with  archive-code 10, MTA  will use the
  5066.  program supplied in UNARCPATH by default, EVEN when A.ARC was a  NoGate
  5067.  archive with crushed  files (in which  case the decompress  will result
  5068.  in an error).  When the PAKPath  option IS available  but the UNARCPath
  5069.  option is NOT, A.ARC will be  marked as a NoGate archive (even  when it
  5070.  is SEA  eXtended) and  the program  supplied in  the PAKPath  option is
  5071.  used (resulting in an  error when A.ARC was  SEA eXtended).  When  BOTH
  5072.  are NOT supplied,  MTA will give  an error because  neither PAKPath nor
  5073.  UNARCPath are present.
  5074.  
  5075.  The special  dirty tricks  that must  be executed  on these  files will
  5076.  result  in  somewhat  overhead  but  should  work full-proof. Because I
  5077.  dislike 2 versions per  day, I do the  same with archives that  contain
  5078.  only ARC-version 11 files). Normal  users should not use the  UNARCPath
  5079.  option  UNLESS  they  got  trouble.  SDS/SDN  sysops will have no other
  5080.  choice than to include them (in general).
  5081.  
  5082.  You can make up your own mind about all these special tricks that  must
  5083.  be executed to serialize an archive  in the correct way. I myself  find
  5084.  it rather strange that these mixups are created in the first place.
  5085.  
  5086.  
  5087.  3.13 Using newer versions of archivers
  5088.  ───────────────────────────────────────────────────────────────────────
  5089.  Once in a while you receive new versions of the archivers that you  use
  5090.  (or don't use). In  some cases, it is  quit a risk to  start converting
  5091.  all  files  to  the  new  version  (certainly  when  you  receive  beta
  5092.  versions) and in some other cases  you would like to see if  a specific
  5093.  new option is indeed working and giving you the expected result.
  5094.  
  5095.  UNLESS the  internal format  of the  archive is  changed, MTA  can work
  5096.  with a ALTernate set of  archive-program versions. This comes in  handy
  5097.  when you want to test the new version on various files but in the  mean
  5098.  while  you  would  like  to  convert  all  other  files  with the older
  5099.  version.
  5100.  
  5101.  All you have to do is the following:
  5102.  
  5103.  - Rename the new version (for example, you receive PKZIP/PKUNZIP  2.0ß,
  5104.    in  which  case   you  could  rename   PKZIP.EXE  to  P2ZIP.EXE   and
  5105.    PKUNZIP.EXE to P2UNZIP.EXE);
  5106.  
  5107.  - Alter the xxxPath option(s) in MTA.CTL. You must add the path to  the
  5108.    new version as the LAST parameter in the option. In this example  you
  5109.    add the path, C:\ARC\P2ZIP.EXE to  the PKZIPPath option and also  you
  5110.    add  C:\ARC\P2UNZIP.EXE  to  the  PKUNZIPPath  option. They will look
  5111.    something like:
  5112.  
  5113.    PKZIPPath   C:\ARC.PKZIP.EXE   N 200 C:\ARC\P2ZIP.EXE
  5114.    PKUNZIPPath C:\ARC.PKUNZIP.EXE N 200 C:\ARC\P2UNZIP.EXE
  5115.  
  5116.    You can do this for each and every archiver (GIF-conversion  program)
  5117.    you use;
  5118.  
  5119.  - Alter the xxxVersion option in  MTA.CTL. You must add the version  of
  5120.    the new release as the second parameter to the xxxVersion  option(s).
  5121.    In the example, you  normally use PKZIP 1.10  and will start to  test
  5122.    the PKZIP 2.01. In  this case you change  ZIPVersion so it will  have
  5123.    both values showed (ZIPVersion 110 201);
  5124.  
  5125.  When you are finished with the  changes, you can execute MTA as  normal
  5126.  to get  the 'normal'  versions of  all archivers.  When you execute MTA
  5127.  with  the  (optional)  /ALT  command-line  parameter,  MTA will look if
  5128.  there is  a second  path available  inside the  xxxPath option and will
  5129.  use THAT one.  If it is  not set, MTA  will use the  original path from
  5130.  this option (e.g. there is no new version present). After this  routine
  5131.  is  finished,  MTA  will  look  if  there  is a second value set in the
  5132.  xxxVersion. If so, MTA will use that one, otherwise the original  value
  5133.  (or the default value) is used. With our example and in short:
  5134.  
  5135.  MTA *.*         will convert files, using  PKZIP/PKUNZIP (1.10)    when
  5136.                  needed, to the format you have set;
  5137.  
  5138.  MTA *.* /ALT    will  convert files, using  P2ZIP/P2UNZIP (2.01)   when
  5139.                  needed, to the format you have set;
  5140.  
  5141.  ┌───────┬─────────────────────────────────────────────────────────────┐
  5142.  │   4   │ Runtime information                                         │
  5143.  └───────┴─────────────────────────────────────────────────────────────┘
  5144.  
  5145.  4.1 Command-line parameters
  5146.  ───────────────────────────────────────────────────────────────────────
  5147.  Most of  the information  that MTA  needs is  obtained from the MTA.CTL
  5148.  configuration  file.  When  you  want  to  change  one (or some) of the
  5149.  options temporary, you can use command-line parameters to do so.
  5150.  
  5151.  The syntax to start execution of MTA is:
  5152.  
  5153.  MTA {filespec} {filespec}..{filespec} {CMD} {CMD}..{CMD}
  5154.  
  5155.  {filespec} is  the  optional  wildcard  (or complete filename) you  can
  5156.             supply. You can supply up  to 25 {filespec} values. You  can
  5157.             use the normal DOS  wildcards AND the special  wildcard that
  5158.             is supplied in  almost ALL DISP-programs.  This is the  '='.
  5159.             This wildcard  can be  used for  a shifted  test. =MTA  will
  5160.             select  files   with  the   names  doMTA.bat,   MTAtest.zip,
  5161.             newMTA.me. If you want to  include the '.', you MUST  supply
  5162.             it in the wildcard. =A.Z will include mtaA.Zip and so on.
  5163.  
  5164.             If you do  not supply a  {filespec} a full-screen  menu will
  5165.             be  shown.  This  menu  can  be  used to select files in ONE
  5166.             directory.
  5167.  
  5168.  {CMD}      You  can  (optionally)   supply  one  or more   command-line
  5169.             options  when  you  execute  MTA.  Some  of  the work like a
  5170.             toggle, some  of the  overrule options  in MTA.CTL,  some of
  5171.             the can only switch on or off in MTA.CTL.
  5172.  
  5173.             A  command-line  parameter  must  start  with a slash ('/').
  5174.             Multiple command-line parameters  must be separated  with at
  5175.             least one  space. If  the command-line  parameter has  extra
  5176.             values, the  must follow  the parameter  itself WITHOUT  any
  5177.             spaces between the command-line parameter and the value.  If
  5178.             the value must  include spaces, you  must replace them  with
  5179.             the underscore character. So if you use the /M  command-line
  5180.             option to move files to C:\ZIP, you must supply /MC:\ZIP;
  5181.  
  5182.  The following command-line options are available and can be used:
  5183.  
  5184.  4.1.1 Command-line parameters that stand on their own
  5185.  ───────────────────────────────────────────────────────────────────────
  5186.  The following command-line  parameters can be  used (in special  cases)
  5187.  and they don't have any counterpart in MTA.CTL.
  5188.  
  5189.  
  5190.  ┌─────────────────────────────────────────────────────────────────────┐
  5191.  │ /?                                                                  │
  5192.  └─────────────────────────────────────────────────────────────────────┘
  5193.  Function : Using /? will  activate MTA's help system. When  this system
  5194.             is invoked, no conversion will be possible. You are shown  a
  5195.             screen where  all command-line  options are  described.  You
  5196.             can now hit the [ENTER] key and you will have the option  to
  5197.             setup the  calling sequence  for MTA.  You can  do this  for
  5198.             different options until  you have all  the options you  need
  5199.             (so you can read about  the option and its syntax  while you
  5200.             can write  it down  in the  help-screen's little note-book).
  5201.             When you have finished (use  [ESC]), the system will make  a
  5202.             batch-file, called GOMTA.BAT  with all this  options inside.
  5203.             You can  start this  batch-file (and  you can  even add some
  5204.             extra parameters to it);
  5205.  
  5206.  ┌─────────────────────────────────────────────────────────────────────┐
  5207.  │ /CTL[path]                                                          │
  5208.  │ /CTL[file]                                                          │
  5209.  └─────────────────────────────────────────────────────────────────────┘
  5210.  Function : By default,  MTA will use MTA.CTL  IF the file is  somewhere
  5211.             in  the  DOS  path  (DOS  2.x  and  higher),  in the current
  5212.             directory (all DOS versions)  or in the directory  where the
  5213.             MTA.EXE file resides (DOS  3.x and higher). If  your MTA.CTL
  5214.             does not  follow this  conventions OR  you want  to assign a
  5215.             different name for it OR  you want to use an  alternate file
  5216.             for special tasks, you can instruct MTA to use this file  if
  5217.             you supply the /CTL command-line parameter. It comes in  two
  5218.             forms. Either  you supply  a complete  path (eg.  the drive,
  5219.             directory and filename, or you just supply the filename,  if
  5220.             MTA is able to  find it in the  same was as it  can find the
  5221.             MTA.CTL (path, current directory, executed directory).
  5222.  
  5223.  ┌─────────────────────────────────────────────────────────────────────┐
  5224.  │ /TASKnn                                                             │
  5225.  └─────────────────────────────────────────────────────────────────────┘
  5226.  Function : If you  want to run multiple  (concurrent) runs of MTA,  you
  5227.             must  supply  a  task-number  to  each  of  the concurrently
  5228.             running  tasks.  By  default,  MTA  assumes that is will run
  5229.             stand alone. If  this is not  the case, you  must supply the
  5230.             /TASK switch  with a  task-number from  01 to  99. Each con-
  5231.             currently running MTA must have a different task-number !
  5232.  
  5233.  ┌─────────────────────────────────────────────────────────────────────┐
  5234.  │ /LVL0                                                               │
  5235.  │ /LVL1                                                               │
  5236.  │ /LVL2                                                               │
  5237.  │ /LVL3                                                               │
  5238.  └─────────────────────────────────────────────────────────────────────┘
  5239.  Function : There are several  command-line parameters that can be  used
  5240.             to  limit  (extend)  the  search  for files to be converted.
  5241.             The set  of /LVLx  command-line parameters  can be  used (in
  5242.             combination with  the filemask(s))  to define  WHERE MTA has
  5243.             to look for files. They  can be used as command-line  driven
  5244.             replacement for some of the options in MTA.CTL  (DefaultPath
  5245.             to name one). The search is extended in the following way:
  5246.  
  5247.             /LVL0 : The  search will be  done in the  CURRENT directory.
  5248.                     This is the  same as NOT  using any DefaultPath  (or
  5249.                     alike) option in  MTA.CTL or using  /W when you  did
  5250.                     set these options.  It can be  overruled to run  MTA
  5251.                     from  the   command-line  for   just  the    current
  5252.                     directory without having  to change the  DefaultPath
  5253.                     (or alike) options in MTA.CTL;
  5254.  
  5255.             /LVL1 : With /LVL1,  MTA will  look in  all  sub-directories
  5256.                     under (NOT INCLUDING) the current directory;
  5257.  
  5258.             /LVL2 : With /LVL2,  MTA will  look in  all  sub-directories
  5259.                     under AND the current directory;
  5260.  
  5261.             /LVL3 : With /LVL3, MTA will search the whole CURRENT  drive
  5262.                     (all directories included);
  5263.  
  5264.  ┌─────────────────────────────────────────────────────────────────────┐
  5265.  │ /@[path]                                                            │
  5266.  └─────────────────────────────────────────────────────────────────────┘
  5267.  Function  :  All  the  files  you  want  to  convert can be selected in
  5268.             several ways.  The usage  of the  /@ command-line  option is
  5269.             just  only  one  of  them.  [path]  must  point  to a drive,
  5270.             directory  and  filename  that  exists.  This file must be a
  5271.             ASCII flat-file  (created with  any normal  line-editor) and
  5272.             it must contain  one filename on  each line (any  drives and
  5273.             directories are stripped by MTA internally). All files  must
  5274.             reside  in  one  directory.  It  is allowed to use wildcards
  5275.             but, unlike the  masks you can  supply on the  command-line,
  5276.             the extension '.*' is NOT  added when you do not  supply any
  5277.             extension.   MTA  will  convert  all  these  files  (if they
  5278.             exist) after each  other. You can  use /@ when  the masks on
  5279.             the normal command-line would  exceed the maximum number  of
  5280.             bytes of a parameter list;
  5281.  
  5282.  ┌─────────────────────────────────────────────────────────────────────┐
  5283.  │ /IP[password]                                                       │
  5284.  └─────────────────────────────────────────────────────────────────────┘
  5285.  Function : With  MTA you can  convert encrypted files.  When you select
  5286.             such files, you MUST  supply the original password  that was
  5287.             used for encryption.  You can only  supply ONE password  for
  5288.             each  execution  of  MTA,  so  when you must convert various
  5289.             files with  various passwords,  you must  do so  in separate
  5290.             runs of MTA. The password that is needed for the  decompress
  5291.             of the input-file,  is supplied with  the /IP option.  There
  5292.             is (obvious) no counterpart in MTA.CTL;
  5293.  
  5294.  ┌─────────────────────────────────────────────────────────────────────┐
  5295.  │ /OP[password]                                                       │
  5296.  │ /OP@                                                                │
  5297.  └─────────────────────────────────────────────────────────────────────┘
  5298.  Function : It is possible to  let MTA create new archives that  will be
  5299.             encrypted with  a password.  In this  case, you  must supply
  5300.             the password  for the  target files,  which is  used as  the
  5301.             password for compression IF  the target system supports  any
  5302.             encryption in this way. Any target files with passwords  are
  5303.             (optionally)  recorded  in  a  log-file  (filename  and  the
  5304.             password). There is no counterpart in MTA.CTL BUT you  could
  5305.             use the xxxCompression options  to set a fixed  password (if
  5306.             needed).
  5307.  
  5308.             When you  use /OP  with a  password, you  can also  use some
  5309.             macros  inside  [password],  in  which  case  MTA  will do a
  5310.             substitution  of  the  macros.  The  following  macros   are
  5311.             available:
  5312.  
  5313.             $JD : Replaced by julian-date number. This is the number  of
  5314.                   days, counted from the  start of the year,  so January
  5315.                   31th  will  be  date-number  31,  February 2nd will be
  5316.                   number 33 and so on;
  5317.  
  5318.             $JY : Replaced by the  year-component. These are the last  2
  5319.                   bytes of the year (so 92 for 1992);
  5320.  
  5321.             $ND : The current day   (2 positions always);
  5322.  
  5323.             $NM : The current month (2 positions always);
  5324.  
  5325.             $NY : The current year  (4 positions always);
  5326.  
  5327.             $FN : The current filename (only name, not extension)
  5328.  
  5329.             /OP$JY$JDRvh will  create a  password of  92002Rvh when used
  5330.             on January  2nd 1992.  With this  macros you  can create any
  5331.             password you like, as long  as the target password (and  the
  5332.             supplied [password]) will NOT contain any spaces.
  5333.  
  5334.             /OP@ is a special form  of password usage for output  files.
  5335.             If you supply /OP@, MTA will generate a RANDOM password  for
  5336.             every file it  converts. In this  case the logging  of these
  5337.             passwords is mandatory otherwise you would never know  which
  5338.             passwords were assigned to which files. These IS some  usage
  5339.             for this option.  You can allow  users to download  ANYTHING
  5340.             from your system but they  can only use the files  when they
  5341.             obtain the  password in  another way  (by calling  you on  a
  5342.             separate line, by paying you in which case you can send  the
  5343.             passwords by mail etc.);
  5344.  
  5345.  ┌─────────────────────────────────────────────────────────────────────┐
  5346.  │ /ALT                                                                │
  5347.  └─────────────────────────────────────────────────────────────────────┘
  5348.  Function : When you  have set  SPECIAL versions  of archivers (see  the
  5349.             xxxPath and xxxVersion options in MTA.CTL) that can be  used
  5350.             (on  request)  for  testing  or  swift  conversion,  you can
  5351.             select THESE  versions (which  are not  the normal versions)
  5352.             by  using  the  /ALT  command-line  parameter.  When /ALT is
  5353.             used, MTA will look if an alternate version of any  archiver
  5354.             is set and will, if set, this version (if needed). If  there
  5355.             is  no  special  version  set,  /ALT  will  cause the normal
  5356.             version to be  used. See the  chapter on using  new versions
  5357.             of archivers;
  5358.  
  5359.  ┌─────────────────────────────────────────────────────────────────────┐
  5360.  │ /SIM                                                                │
  5361.  └─────────────────────────────────────────────────────────────────────┘
  5362.  Function : This  option  can  be   used  to  execute  MTA in a kind  of
  5363.             simulate mode. For  each archive to  be converted, MTA  will
  5364.             do the following:
  5365.  
  5366.             - Decompress the file;
  5367.             - Scan for Virus;
  5368.             - Call exits;
  5369.  
  5370.             This option  comes in  handy when  you execute  MTA under  a
  5371.             door inside  a BBS  (FileDoor) to  look for  a virus  inside
  5372.             files,  the  moment  the  file  is  uploaded or to check you
  5373.             files  (without  a  convert)  when  a  new  virus-scanner is
  5374.             released.   There   is  no  counterpart   option  for   this
  5375.             command-line parameter in the MTA.CTL file;
  5376.  
  5377.  ┌─────────────────────────────────────────────────────────────────────┐
  5378.  │ /DATE                                                               │
  5379.  └─────────────────────────────────────────────────────────────────────┘
  5380.  Function : This  option  can  be   used  to  execute  MTA in a kind  of
  5381.             simulate mode. For  each archive to  be converted, MTA  will
  5382.             do the following:
  5383.  
  5384.            - Test if the file matches any mask;
  5385.  
  5386.            - If it does,  test if the date  is lower than the  date that
  5387.              you supplied in the DelOldFiles option;
  5388.  
  5389.            - If it  does, manipulate the  file (delete, move)  depending
  5390.              on the DelOldPath option;
  5391.  
  5392.            This option  comes in  handy when  you execute  MTA to remove
  5393.            (without  conversion)  all  your  files  that  are too old to
  5394.            keep.
  5395.  
  5396.  ┌─────────────────────────────────────────────────────────────────────┐
  5397.  │ /ANS[type]                                                          │
  5398.  └─────────────────────────────────────────────────────────────────────┘
  5399.  Function : When this  command-line parameter  is NOT  set AND MTA  will
  5400.             use remote  logging, MTA  will use  ANSI sequences.  This is
  5401.             also  the  case  when  you  code  any  value from 1 to 9 for
  5402.             [type].  If  you  use  the  value  0 for [type] MTA will use
  5403.             ASCII for remote logging;
  5404.  
  5405.  ┌─────────────────────────────────────────────────────────────────────┐
  5406.  │ /D{=d:}                                                             │
  5407.  └─────────────────────────────────────────────────────────────────────┘
  5408.  Function : With this parameter  you instruct MTA to start  the diskette
  5409.             support as described before. There is no alternative  option
  5410.             for  it  in  MTA.CTL.   When  you  use  /D,  MTA  will start
  5411.             diskette  support  for  DRIVE  A:.   If  your  diskettes are
  5412.             accessed from another  drive (eg.   B:), you must  use /D=B:
  5413.             to do so;
  5414.  
  5415.  
  5416.  4.1.2 Command-line parameters that overrule/toggle/disable MTA.CTL
  5417.  ───────────────────────────────────────────────────────────────────────
  5418.  The following command-line parameters  will either switch an  option in
  5419.  MTA.CTL on, off  or will act  like a toggle.  Some can overrule  values
  5420.  that are set in MTA.CTL.
  5421.  
  5422.  
  5423.  ┌─────────────────────────────────────────────────────────────────────┐
  5424.  │ /ARC                                                                │
  5425.  │ /ARJ                                                                │
  5426.  │ /ARJSFX                                                             │
  5427.  │ /DWC                                                                │
  5428.  │ /HYP                                                                │
  5429.  │ /LZH                                                                │
  5430.  │ /LZHSFX                                                             │
  5431.  │ /LZS                                                                │
  5432.  │ /MD                                                                 │
  5433.  │ /OWN                                                                │
  5434.  │ /PAK                                                                │
  5435.  │ /PAKSFX                                                             │
  5436.  │ /ZIP                                                                │
  5437.  │ /ZIPSFX                                                             │
  5438.  │ /ZOO                                                                │
  5439.  │ /PKLITE                                                             │
  5440.  │ /UNPKLITE                                                           │
  5441.  │ /GIFLITE                                                            │
  5442.  │ /GIF2JPG                                                            │
  5443.  │ /JPG2GIF                                                            │
  5444.  │ /GIF                                                                │
  5445.  └─────────────────────────────────────────────────────────────────────┘
  5446.  Function : Normally MTA will  convert all matched (and selected)  files
  5447.             to the system you assigned to the CompressionType option  in
  5448.             MTA.CTL. With these  command-line switches you  can overrule
  5449.             them with another format  (see CompressionType option for  a
  5450.             description of the various supported targets);
  5451.  
  5452.  ┌─────────────────────────────────────────────────────────────────────┐
  5453.  │ /NO4DOS                                                             │
  5454.  └─────────────────────────────────────────────────────────────────────┘
  5455.  Function : When you  run under  4DOS <tm>  and you  want to  use  MTA's
  5456.             internal move  options, you   can overrule  the 4DOS    <tm>
  5457.             MOVE command   with   this   parameter.   It   has the  same
  5458.             meaning  as  when  you  include  the  Not4DOSAware option in
  5459.             MTA.CTL.
  5460.  
  5461.  ┌─────────────────────────────────────────────────────────────────────┐
  5462.  │ /W{directory}                                                       │
  5463.  └─────────────────────────────────────────────────────────────────────┘
  5464.  Function : When you  have included  DefaultPath (or  alike) options  in
  5465.             MTA.CTL, or you wish  to convert files in  another directory
  5466.             as the current, you can include /W. /W by itself will  over-
  5467.             rule  any  DefaultPath  (or  alike,  like RAPaths) option in
  5468.             MTA.CTL  and  will  force  MTA  to  work  inside the CURRENT
  5469.             directory. /W{directory}  (so you  append a  valid directory
  5470.             to the parameter, like /WD:\ZIP)  will force MTA to work  on
  5471.             the supplied directory;
  5472.  
  5473.  ┌─────────────────────────────────────────────────────────────────────┐
  5474.  │ /C                                                                  │
  5475.  │ /H                                                                  │
  5476.  │ /L                                                                  │
  5477.  │ /F                                                                  │
  5478.  └─────────────────────────────────────────────────────────────────────┘
  5479.  Function : One of  these command-line  parameters can  be used (if  you
  5480.             use multiple at the same time, only the last will count)  to
  5481.             overrule the touching system that MTA uses. If you have  set
  5482.             a  way  of  touching  (TouchHig,  TouchCur, TouchLow) in the
  5483.             MTA.CTL,  these  parameters  can  be  used  to overrule this
  5484.             option in the following way:  /C : Converted files will  get
  5485.             the  current  date;  /H  :  The  same  as  using TouchHig in
  5486.             MTA.CTL (highest date)  /L : The  same as using  TouchLow in
  5487.             MTA.CTL (lowest   date) /F :  Files will keep  the same date
  5488.             as they had before the conversion started;
  5489.  
  5490.  ┌─────────────────────────────────────────────────────────────────────┐
  5491.  │ /M{directory}                                                       │
  5492.  └─────────────────────────────────────────────────────────────────────┘
  5493.  Function : If you  use the MoveToDir option  in MTA.CTL you can  use /M
  5494.             on its own to make that option inactive. If you also  append
  5495.             a directory (eg. /MD:\ZIP\TRA), it will work the same as  if
  5496.             you supplied  D:\ZIP\TRA as  the directory  in this  option.
  5497.             So  /MD:\ZIP\TRA  will  move  converted  files to D:\ZIP\TRA
  5498.             even when the MoveToDir  option in MTA.CTL is  set otherwise
  5499.             or when it is not set at all;
  5500.  
  5501.  ┌─────────────────────────────────────────────────────────────────────┐
  5502.  │ /C2G[options]                                                       │
  5503.  │ /C2J[options]                                                       │
  5504.  │ /CD[options]                                                        │
  5505.  │ /CGL[options]                                                       │
  5506.  │ /CH[options]                                                        │
  5507.  │ /CHS[options]                                                       │
  5508.  │ /CJ[options]                                                        │
  5509.  │ /CJS[options]                                                       │
  5510.  │ /CL[options]                                                        │
  5511.  │ /CQ[options]                                                        │
  5512.  │ /CZ[options]                                                        │
  5513.  │ /CZS[options]                                                       │
  5514.  │ /CGT[options]                                                       │
  5515.  └─────────────────────────────────────────────────────────────────────┘
  5516.  Function : For  almost all archivers  (and GIF-alike programs)  you can
  5517.             add some extra options for  each and every archiver (or  GIF
  5518.             program).  These  options  can  be  found  in MTA.CTL as the
  5519.             xxxCompression options (see over there). You can also  over-
  5520.             rule them (or add them  on the fly) with these  command-line
  5521.             parameters. [options]  must be  the added  options for  that
  5522.             archiver. Spaces must be replaced by underscore  characters,
  5523.             so '-a -z'  must be coded  as '-a_-z' (without  the quotes).
  5524.             Each of the command-line parameter stands for:
  5525.  
  5526.             - /C2G        GIF2JPG
  5527.             - /C2J        JPG2GIF
  5528.             - /CD         DWC
  5529.             - /CGL        GIFLITE
  5530.             - /CH         LZH
  5531.             - /CHS        LZH (SFX)
  5532.             - /CJ         ARJ
  5533.             - /CJS        ARJ (SFX)
  5534.             - /CL         PKLITE
  5535.             - /CQ         ZOO
  5536.             - /CZ         ZIP
  5537.             - /CZS        ZIP2EXE (ZIP SFX)
  5538.             - /CGT        GIFTEST
  5539.  
  5540.             Refer to the documentation for  each archiver to see a  list
  5541.             of non-common options that  can be used. Also  remember that
  5542.             the SFX creation is done  AFTER the compression (and NOT  at
  5543.             the  same  time,  even  if  the compression program supports
  5544.             it).   This means  that adding  something for  LZH SFX  will
  5545.             cause that it will  ONLY be used to  create the SFX and  NOT
  5546.             for  the  compression  of  the  LZH-file  (same goes for all
  5547.             other SFX's);
  5548.  
  5549.  ┌─────────────────────────────────────────────────────────────────────┐
  5550.  │ /Z{path}                                                            │
  5551.  └─────────────────────────────────────────────────────────────────────┘
  5552.  Function :  This command-line  parameter has  the same  meaning as  the
  5553.             usage of  the AutoDescription  option in  MTA.CTL. When  you
  5554.             use /Z as is, the AutoDescription option (if set) is  turned
  5555.             off and no  comments will be  added. When you  append a path
  5556.             (the drive,  directory and  filename) to  the parameter, the
  5557.             file  that  you  supply  will  be  added  as  comment to all
  5558.             converted archives that support  these comments. As such  it
  5559.             can be  used to  (temporary) add  the AutoDescription  or to
  5560.             overrule the values set in MTA.CTL;
  5561.  
  5562.  ┌─────────────────────────────────────────────────────────────────────┐
  5563.  │ /CARCOM{n}                                                          │
  5564.  └─────────────────────────────────────────────────────────────────────┘
  5565.  Function : This command-line option can be used to change the  behavior
  5566.             of the CarryComment  option in MTA.CTL  (if set).   When you
  5567.             supply /CARCOM  as is,  the CarryComment  option in  MTA.CTL
  5568.             will  be  (temporary)  switched  off.  If  you  use /CARCOMn
  5569.             (where 'n' is  the number 1,  2 or 3),  you can (re)set  the
  5570.             function of the CarryComment option for this run;
  5571.  
  5572.  ┌─────────────────────────────────────────────────────────────────────┐
  5573.  │ /AFB                                                                │
  5574.  └─────────────────────────────────────────────────────────────────────┘
  5575.  Function : This command-line parameter is a toggle for the  AddFilesBBS
  5576.             option in MTA.CTL;
  5577.  
  5578.  ┌─────────────────────────────────────────────────────────────────────┐
  5579.  │ /P                                                                  │
  5580.  └─────────────────────────────────────────────────────────────────────┘
  5581.  Function : When  you use the  /P command-line parameter,  MTA will stop
  5582.             any logging in  the normal log-file(s)  for the duration  of
  5583.             the run.
  5584.  
  5585.  ┌─────────────────────────────────────────────────────────────────────┐
  5586.  │ /DI                                                                 │
  5587.  │ /DE                                                                 │
  5588.  │ /DD                                                                 │
  5589.  └─────────────────────────────────────────────────────────────────────┘
  5590.  Function :  You can  disable the  functions of  the options IncludeFile
  5591.             (/DI), ExcludeFile  (/DE) and  the DoNot  (/DD) options with
  5592.             help of these command-line parameters;
  5593.  
  5594.  ┌─────────────────────────────────────────────────────────────────────┐
  5595.  │ /E1                                                                 │
  5596.  │ /E2                                                                 │
  5597.  │ /EB                                                                 │
  5598.  │ /EG                                                                 │
  5599.  └─────────────────────────────────────────────────────────────────────┘
  5600.  Functions : Any  exit  you   have  declared, can be disabled. /E1  will
  5601.              disable ExitBeforeFill (if set),  /E2 will do the  same for
  5602.              ExitAfterFill (if set),  /EB for ExitBetweenConversion  and
  5603.              /EG for  ExitAfterCompression. Exits  can only  be SET with
  5604.              help of options in MTA.CTL;
  5605.  
  5606.  ┌─────────────────────────────────────────────────────────────────────┐
  5607.  │ /U                                                                  │
  5608.  │ /U[filename]                                                        │
  5609.  │ /U[path]                                                            │
  5610.  └─────────────────────────────────────────────────────────────────────┘
  5611.  Function : This  command-line   parameter  comes in three flavors.  The
  5612.             first, /U, is a toggle  for the FilesBBS option in  MTA.CTL.
  5613.             /U will  disable the  option if  it was  set in  MTA.CTL and
  5614.             will enable the option if it was not set.
  5615.  
  5616.             /U[filename] will  enable the  FilesBBS option  but in  this
  5617.             case you  overrule the  filename FILES.BBS  (in the  working
  5618.             directory) with [filename].
  5619.  
  5620.             /U[path] will enable  the FilesBBS option  but in this  case
  5621.             you overrule the filename  FILES.BBS AND the fact  that this
  5622.             file  must  reside  in  EACH  working directory with [path].
  5623.             [path] is  the SINGLE  filename (with  drive and  directory)
  5624.             that MTA will update (RBBS master directory and such);
  5625.  
  5626.  ┌─────────────────────────────────────────────────────────────────────┐
  5627.  │ /NOOLD                                                              │
  5628.  └─────────────────────────────────────────────────────────────────────┘
  5629.  Function : When  you added the  DelOldFiles option to  MTA.CTL, you can
  5630.             use /NOOLD to switch the option off.
  5631.  
  5632.  ┌─────────────────────────────────────────────────────────────────────┐
  5633.  │ /UPGRADE                                                            │
  5634.  └─────────────────────────────────────────────────────────────────────┘
  5635.  Function : This command-line parameter is a toggle for the  OnlyUpgrade
  5636.             option in MTA.CTL;
  5637.  
  5638.  ┌─────────────────────────────────────────────────────────────────────┐
  5639.  │ /SBA                                                                │
  5640.  └─────────────────────────────────────────────────────────────────────┘
  5641.  Function : This command-line parameter is a toggle for the  SkipBackups
  5642.             option in MTA.CTL;
  5643.  
  5644.  ┌─────────────────────────────────────────────────────────────────────┐
  5645.  │ /NOB                                                                │
  5646.  └─────────────────────────────────────────────────────────────────────┘
  5647.  Function : This  command-line  parameter   is  a toggle for the  NoBeep
  5648.             option in MTA.CTL;
  5649.  
  5650.  ┌─────────────────────────────────────────────────────────────────────┐
  5651.  │ /NVI                                                                │
  5652.  └─────────────────────────────────────────────────────────────────────┘
  5653.  Function : This command-line parameter  will  switch of  the configured
  5654.             virus scanners for the duration of this run.
  5655.  
  5656.  ┌─────────────────────────────────────────────────────────────────────┐
  5657.  │ /NOEMS                                                              │
  5658.  │ /NOXMS                                                              │
  5659.  └─────────────────────────────────────────────────────────────────────┘
  5660.  Function : This command-line  parameters can  be used  to disable   the
  5661.             usage of EMS  and/or XMS. The  same can be  done permanently
  5662.             with the NoEMS and/or NoXMS options in MTA.CTL;
  5663.  
  5664.  ┌─────────────────────────────────────────────────────────────────────┐
  5665.  │ /VMODE{mode}                                                        │
  5666.  └─────────────────────────────────────────────────────────────────────┘
  5667.  Function : /VMODE  as is, will  switch any VideoMode  option in MTA.CTL
  5668.             to OFF.  /VMode{mode} (where  {mode} is  the DECIMAL  video-
  5669.             mode) will force MTA to switch the video-card to {mode};
  5670.  
  5671.  ┌─────────────────────────────────────────────────────────────────────┐
  5672.  │ /EXTTST                                                             │
  5673.  └─────────────────────────────────────────────────────────────────────┘
  5674.  Function : /EXTTST is used  as a toggle for the  ExtendedTesting option
  5675.             in MTA.CTL.
  5676.  
  5677.  ┌─────────────────────────────────────────────────────────────────────┐
  5678.  │ /SFX                                                                │
  5679.  └─────────────────────────────────────────────────────────────────────┘
  5680.  Function : /SFX  is  used  as  a  toggle  for  the SFXFiles option in
  5681.             MTA.CTL;
  5682.  
  5683.  ┌─────────────────────────────────────────────────────────────────────┐
  5684.  │ /LEA                                                                │
  5685.  └─────────────────────────────────────────────────────────────────────┘
  5686.  Function : /LEA is  used as  a toggle  for the  KeepAbnormalExtensions
  5687.             option in MTA.CTL;
  5688.  
  5689.  ┌─────────────────────────────────────────────────────────────────────┐
  5690.  │ /TIM                                                                │
  5691.  └─────────────────────────────────────────────────────────────────────┘
  5692.  Function : When  you use the  /TIM command-line parameter,  you disable
  5693.             the RunTime option in MTA.CTL (if set);
  5694.  
  5695.  ┌─────────────────────────────────────────────────────────────────────┐
  5696.  │ /NEW                                                                │
  5697.  └─────────────────────────────────────────────────────────────────────┘
  5698.  Function : /NEW is  used as  a toggle  for the  OnlyNewFiles option in
  5699.             MTA.CTL;
  5700.  
  5701.  ┌─────────────────────────────────────────────────────────────────────┐
  5702.  │ /MAR                                                                │
  5703.  └─────────────────────────────────────────────────────────────────────┘
  5704.  Function : /MAR  is  used  as   a  toggle  for  the NoMarked option  in
  5705.             MTA.CTL;
  5706.  
  5707.  ┌─────────────────────────────────────────────────────────────────────┐
  5708.  │ /MAH{string}                                                        │
  5709.  └─────────────────────────────────────────────────────────────────────┘
  5710.  Function : If you want to  change the value for the MarkHeader  option,
  5711.             you can use the  /MAH{string} command-line option. When  you
  5712.             do  not  supply  {string},  MTA  will  be  forced to use the
  5713.             default value. When used, {string} must be 6 bytes of less;
  5714.  
  5715.  ┌─────────────────────────────────────────────────────────────────────┐
  5716.  │ /MAS{string}                                                        │
  5717.  └─────────────────────────────────────────────────────────────────────┘
  5718.  Function : If you want to  change the value for the MarkString  option,
  5719.             you can use the  /MAS{string} command-line option. When  you
  5720.             do  not  supply  {string},  MTA  will  be  forced to use the
  5721.             default  value.  When  used,  {string}  must  be 14 bytes of
  5722.             less;
  5723.  
  5724.  ┌─────────────────────────────────────────────────────────────────────┐
  5725.  │ /UNMARK                                                             │
  5726.  └─────────────────────────────────────────────────────────────────────┘
  5727.  Function : /UNMARK  is  used  as   a  toggle  for the UnMark option  in
  5728.             MTA.CTL;
  5729.  
  5730.  ┌─────────────────────────────────────────────────────────────────────┐
  5731.  │ /OOA                                                                │
  5732.  └─────────────────────────────────────────────────────────────────────┘
  5733.  Function : Using /OOA  will do  the same  as using  the  OptimizeOnSize
  5734.             option in MTA.CTL;
  5735.  
  5736.  ┌─────────────────────────────────────────────────────────────────────┐
  5737.  │ /AIA                                                                │
  5738.  └─────────────────────────────────────────────────────────────────────┘
  5739.  Function : /AIA  is  used   as  a  toggle for the NoArcInArc  option in
  5740.             MTA.CTL;
  5741.  
  5742.  ┌─────────────────────────────────────────────────────────────────────┐
  5743.  │ /KEEPAV                                                             │
  5744.  └─────────────────────────────────────────────────────────────────────┘
  5745.  Function : /KEEPAV  is  used  as   a  toggle  for the KeepAV option  in
  5746.             MTA.CTL;
  5747.  
  5748.  ┌─────────────────────────────────────────────────────────────────────┐
  5749.  │ /KEEPVL                                                             │
  5750.  └─────────────────────────────────────────────────────────────────────┘
  5751.  Function : /KEEPVL  is  used  as   a  toggle  for the KeepVL option  in
  5752.             MTA.CTL;
  5753.  
  5754.  ┌─────────────────────────────────────────────────────────────────────┐
  5755.  │ /ALL                                                                │
  5756.  └─────────────────────────────────────────────────────────────────────┘
  5757.  Function : /ALL is used as a toggle for the AllDisketteFiles option  in
  5758.             MTA.CTL;
  5759.  
  5760.  ┌─────────────────────────────────────────────────────────────────────┐
  5761.  │ /BAUD[baudrate]                                                     │
  5762.  │ /COM[comport]                                                       │
  5763.  │ /FOSSIL[fossilport]                                                 │
  5764.  │ /REMOTE                                                             │
  5765.  └─────────────────────────────────────────────────────────────────────┘
  5766.  Function : When MTA is used under a door inside a BBS and you want  MTA
  5767.             to keep the user informed about the current status, you  can
  5768.             use /BAUD, /COM (or /PORT) and /REMOTE (or their  equivalent
  5769.             counterparts in  MTA.CTL) to  do so.  [baudrate] can  be the
  5770.             baudrate  (locked  or  not)  or  0  (in which case NO remote
  5771.             operations will be done). [comport] can be a valid COM  port
  5772.             or 0 (in which case  no remote operations will take  place).
  5773.             [fossilport]  must  be  the  valid  fossil-port, there is no
  5774.             value to  switch remote  operations off  other than  setting
  5775.             [baudrate] to 0.  /COM is preferred.  You can use  all these
  5776.             command-line parameters (or  their counterparts in  MTA.CTL)
  5777.             but they  will do  nothing unless  the following combination
  5778.             is  made  (where  the  command-line  parameters overrule any
  5779.             options in MTA.CTL):
  5780.  
  5781.             - /BAUD (Baudrate) must be set to a non-zero value;
  5782.             - /COM  (ComPort )  ,,  ,,  ,, ,,    ,,  ,,    ,,  OR
  5783.               /FOSSIL (FossilPort) must be used;
  5784.             - /REMOTE (Remote) is used;
  5785.  
  5786.             You should  also look  into the  /ANS command-line parameter
  5787.             in the previous (sub)chapter.
  5788.  
  5789. │┌─────────────────────────────────────────────────────────────────────┐
  5790. ││ /STOSIZ{ext}                                                        │
  5791. │└─────────────────────────────────────────────────────────────────────┘
  5792. │Function : /STOSIZ  is  used   as  a  toggle  for the  StoreSize option
  5793. │           MTA.CTL. When you use this  option to SET the option  to ON,
  5794. │           {ext} (optional)  can be  used to  set the  extension of the
  5795. │           semaphore file  (default XS1)  to something  else (F#D  when
  5796. │           running FileDoor 2.03 or older betas);
  5797. │
  5798. │┌─────────────────────────────────────────────────────────────────────┐
  5799. ││ /STONAM{nam}                                                        │
  5800. │└─────────────────────────────────────────────────────────────────────┘
  5801. │Function : /STONAM  is  used   as  a  toggle  for the  StoreName option
  5802. │           MTA.CTL. When you use this  option to SET the option  to ON,
  5803. │           {nam} (optional)  can be  used to  set the  filename of  the
  5804. │           semaphore  file  (default  FILEDOOR.XS2)  to  something else
  5805. │           (FILEDOOR.F#D when running older FileDoor betas);
  5806. │
  5807. │┌─────────────────────────────────────────────────────────────────────┐
  5808. ││ /STOCOM{nam}                                                        │
  5809. │└─────────────────────────────────────────────────────────────────────┘
  5810. │Function : /STOCOM is used  as  a  toggle  for the  StoreComment option
  5811. │           MTA.CTL. When you use this  option to SET the option  to ON,
  5812. │           {nam} (optional)   can  be   used  to   set the  name of the
  5813. │           semaphore file (default FILEDOOR.XS3) to something else.
  5814.  
  5815.  
  5816.  
  5817.  
  5818.  4.1.3 Command-line parameters with a special usage
  5819.  ───────────────────────────────────────────────────────────────────────
  5820.  The following command-line parameters  are special (should not  be used
  5821.  but  are  documented  to  be  complete)  or  are only used in debugging
  5822.  situations.
  5823.  
  5824.  
  5825.  ┌─────────────────────────────────────────────────────────────────────┐
  5826.  │ /|                                                                  │
  5827.  │ />                                                                  │
  5828.  │ /<                                                                  │
  5829.  └─────────────────────────────────────────────────────────────────────┘
  5830.  Function : These options should (and can not) be used. They can not  be
  5831.             executed  from  the  DOS  command-line  because  they   have
  5832.             something to do  with piping. These  command-line parameters
  5833.             are used by MTA internally !
  5834.  
  5835.  ┌─────────────────────────────────────────────────────────────────────┐
  5836.  │ /PAUSE                                                              │
  5837.  └─────────────────────────────────────────────────────────────────────┘
  5838.  Function : Sometimes MTA will execute a program (archiver, virus  scan,
  5839.             exit  and  so  on)  and  this  programs reports an error. In
  5840.             these cases  you are  not able  to see  what happens because
  5841.             MTA  will  go  on  (after  a  warning  is given). If you use
  5842.             /PAUSE, MTA will pause  (without clearing the screen)  after
  5843.             the shell returns to MTA.  You must press [ESC] to  continue
  5844.             MTA in the normal way;
  5845.  
  5846.  
  5847.  
  5848.  4.2 Aborting MTA
  5849.  ───────────────────────────────────────────────────────────────────────
  5850.  There is only one way to abort MTA before it's normal end. When MTA  is
  5851.  busy, you  can press  [ESC]. MTA  will (in  time) display  that it will
  5852.  terminate soon.  Termination will  be done  AFTER THE  CURRENT FILE  IS
  5853.  CONVERTED !
  5854.  
  5855.  When you did  press [ESC] by  mistake, you can  always press any  other
  5856.  key  to  release  the  pending  termination.  In  that  case,  MTA will
  5857.  continue as normal.
  5858.  
  5859.  The termination option  does NOT work  when you use  the /D switch.  In
  5860.  this case you must wait until the diskette is fully converted.
  5861.  
  5862.  
  5863.  
  5864.  4.3 LOG file
  5865.  ───────────────────────────────────────────────────────────────────────
  5866.  MTA makes a log of almost  everything (unless you specify NoLog in  the
  5867.  MTA.CTL file or supply  /L as a runtime  switch).  You can  browse thru
  5868.  the log with a program like V.Buerg's LIST or with the 'good old'  TYPE
  5869.  command.
  5870.  
  5871.  The log-style can  be adjusted to  the users need  with three different
  5872.  options  (LogStyleFormat,  LogDateFormat  and  LogTimeFormat). Also you
  5873.  can combine  all possible  logs (the  'normal' log,  called MTA.LOG  by
  5874.  default, the  password log,  called MTA.PWN  by default  and the random
  5875.  password log,  called MTA.PWD  by default)  into one  log-file, because
  5876.  MTA will open  (APPEND) and close  the log for  every record it  has to
  5877.  write.
  5878.  
  5879.  Depending on the number of files  MTA has to convert, the MTA.LOG  file
  5880.  can get very large. I have  supplied a program (MTL.EXE) to solve  this
  5881.  problem. With  MTL.EXE you  can make  a statistical  review of your log
  5882.  file. In addition,  you can instruct  MTL to shorten  the log-file. MTL
  5883.  will rewrite the MTA.LOG file with only the total counters so far.  The
  5884.  next run MTL  will detect these  counters again and  adjust the current
  5885.  counters with these values.
  5886.  
  5887.  MTL depends  on the  format of  the log-file.  Therefor you  should not
  5888.  make any changes to the current  log-file, but make a copy of  the file
  5889.  and  work  on  the  copy  and  not  the original. MTL IS able to detect
  5890.  customized log-files  and will  adjust itself  to search  at the  right
  5891.  places. Also, records of a different  kind can be available in the  log
  5892.  (in case of a mailer or BBS program). MTL will skip these records  but.
  5893.  If  you  want  to  clean  the  log  with  MTL, MTL will ALSO remove all
  5894.  NON-MTA data from the log !
  5895.  
  5896.  If you get tired of the log, delete it, and MTA will create a new  one.
  5897.  When MTA calls itself as a child invocation, the child MTA does not  do
  5898.  any type of logging !
  5899.  
  5900.  
  5901.  
  5902.  4.4 Errors
  5903.  ───────────────────────────────────────────────────────────────────────
  5904.  Under some conditions, MTA can  abort (or skip files) which  causes the
  5905.  temporary directory to  stay on disk.  Normally MTA will  try to remove
  5906.  all files  from this  temporary directory  but there  can be cases when
  5907.  this is impossible. In such cases,  MTA will report this at the  end of
  5908.  the run. In that case you  must correct the errors manually and  remove
  5909.  the  directory  (or  directories)  from  disk. Under normal conditions,
  5910.  this  will  only  take  place  with  critical errors (disk failures and
  5911.  such).
  5912.  
  5913.  ┌───────┬─────────────────────────────────────────────────────────────┐
  5914.  │   5   │ Version information and credits                             │
  5915.  └───────┴─────────────────────────────────────────────────────────────┘
  5916.  
  5917.  5.1 The BETA-team
  5918.  ───────────────────────────────────────────────────────────────────────
  5919.  Look into  the file  SUPPORT.MTA for  a full  list of  all beta-testers
  5920.  and support nodes.
  5921.  
  5922.  
  5923.  
  5924.  5.2 Credits
  5925.  ───────────────────────────────────────────────────────────────────────
  5926.  Thanks  to  the  following  people  (besides  my eternal thanks for the
  5927.  BETA team):
  5928.  
  5929.  - All   paying, registered   users. You   made it   possible to enhance
  5930.    MTA with nice features;
  5931.  
  5932.  - All users who did write me bug reports, suggestions and so on;
  5933.  
  5934.  
  5935.  
  5936.  5.3 Version history
  5937.  ───────────────────────────────────────────────────────────────────────
  5938.  
  5939.  ┌───────┬────────────────────────────┐
  5940.  │ 11.xx │ Sampled release info       │
  5941.  └───────┴────────────────────────────┘
  5942.   ■ Bug fixes;
  5943.  
  5944.   ■ Added   FilesBBSFormat   option,   CarryComment   option,  alternate
  5945.     CTL support, combination of /M and /D allowed;
  5946.  
  5947.  ┌───────┬────────────────────────────┐
  5948.  │ 12.xx │ Sample release info        │
  5949.  └───────┴────────────────────────────┘
  5950.   ■ Bug fixes;
  5951.  
  5952.   ■ All  tables  to  255   entries,  tag-menu,  /@,  /MD,    AltDisplay,
  5953.     internal swapping   (SwapPath,  NoSwap),   MDCD  support   (MDPath),
  5954.     IncludeCTL, AV-aware,  encryption   aware,  configurable   log-file,
  5955.     MTAErrorPath, extended help, mouse  aware, ITS aware and  many, many
  5956.     more changes;
  5957.  
  5958.  ┌───────┬────────────────────────────┐
  5959.  │ 13.xx │ Sample release info        │
  5960.  └───────┴────────────────────────────┘
  5961.   ■ MTA swapped from  free-ware to shareware so  now a small price  must
  5962.     be payed for continued usage;
  5963.  
  5964.   ■ Several bugs fixed;
  5965.  
  5966.   ■ Added support for 4DOS descriptions, EGA/VGA special text-modes
  5967.  
  5968.  ┌───────┬────────────────────────────┐
  5969.  │ 14.xx │ Sample release info        │
  5970.  └───────┴────────────────────────────┘
  5971.   ■ Fixed some bugs;
  5972.  
  5973.   ■ Added  support  for  volume-labels  (ZIP/ARJ),  special   log-files,
  5974.     descriptions, substituted drives  (recursive support), VGA  support,
  5975.     special selections (/LVLx),  sharing and multi-tasking  (also multi-
  5976.     MTA), ARJ, multiple  virus scanners, HYP(er),  PKLITE, menu-tagging,
  5977.     better help, LZH 2.xx support, videomode, TICK, FES, untyped  files,
  5978.     simulation, macros in  the password command-line  parameters, remote
  5979.     logging, files that are too old, XARC/ARCE, ZOO 2.xx,
  5980.  
  5981.  ┌───────┬────────────────────────────┐
  5982.  │ 15.01 │ Major Release              │
  5983.  └───────┴────────────────────────────┘
  5984.   ■ I did  an almost complete  rewrite of the  documentation. Many cross
  5985.     references are now explained at their proper locations, old info  is
  5986.     removed  (a  couple  of  chapters),  all  options  and  command-line
  5987.     parameters  are  revised  and  (I  hope)  better explained. The only
  5988.     thing that still is  on the list, is  an index and a  proper utility
  5989.     to create the  page numbers for  the various users.  Overall the new
  5990.     documentation is  somewhat smaller  than the  previous version while
  5991.     still giving you all relevant information;
  5992.  
  5993.   ■ The  internals of  MTA have  changed completely.  This causes MTA to
  5994.     use almost  the same  amount of  memory as  before though  there are
  5995.     many options added.  There is also  a separate overlayed  version of
  5996.     MTA  available  (MTAOVR)  that  uses  100K  less  of  (conventional)
  5997.     memory;
  5998.  
  5999.   ■ There was  a serious bug  in the RAPATHS  option logic, causing  MTA
  6000.     not  to  recognize  the  FILES.RA  file.  This is fixed. The RAPATHS
  6001.     option is  somewhat changed  in syntax  and the  RA0 and RA1 options
  6002.     are removed from MTA;
  6003.  
  6004.   ■ The  dos-shell  in  MTA  (you  know, the little window) was  getting
  6005.     somewhat old for the current state  of the technique.  The same  was
  6006.     true for  the swapping  routines. They  are all  replaced and we now
  6007.     have 4  new DOS-shell  routines in  MTA (2  non swapped,  2 swapped,
  6008.     each pair consisting of  a windowed and non-windowed  routine). This
  6009.     also  causes  archivers  that  needed  a  swap,  to  stay inside the
  6010.     DOS-window  as  were  the  non-swapped  archivers.  Because of these
  6011.     changes the  STOWBUFFER and  FORCECGA options  are removed  from MTA
  6012.     and are now obsolete;
  6013.  
  6014.   ■ Changed  the logic  for AV'ed  files. Previous  versions would  give
  6015.     errors under special conditions. This problem is fixed;
  6016.  
  6017.   ■ Fixed a problem  where MTA could make  a mess of ARJ  AV'ed archives
  6018.     (if KEEPAV was  set) in combination  with AutoDescription. If  these
  6019.     conditions  were  met  (KEEPAV,  ARJ-AV,  AutoDescription)  and  the
  6020.     target was ZIP, MTA would  add a description to the  ARJ-file, using
  6021.     internal patching techniques, causing  the target-file to be  defect
  6022.     (you could still extract them, but with a warning). This is fixed;
  6023.  
  6024.   ■ Changed  the  logic  for  SFX  files. Previous versions did  contain
  6025.     their own  logic to  remove the  SFX-header from  the archives. This
  6026.     coding is removed  and MTA should  be able to  convert SFX files  if
  6027.     the  archiver  can  extract  files  from  the  SFX'ed  file.  By  my
  6028.     knowledge,  there  is  only  one  non-standard SFX-file. This is the
  6029.     ZOO-SFX created  with a  separate program.  These files  can not  be
  6030.     converted when ZOO  is not able  to decompress files  from the *.EXE
  6031.     files.  Overall,  this  will  give  a  much more secure (and version
  6032.     independent) result;
  6033.  
  6034.   ■ The  /M  (MOVETOPATH)  command-line  parameter  could  be used  with
  6035.     invalid directory names. MTA would report errors when the  converted
  6036.     files  was  actually  moved  to  this  directory  or a file would be
  6037.     renamed (convert RA_110.ZIP to ZIP,  with /MTRA where TRA was  not a
  6038.     valid directory.  The result  was a  file TRARA_11.ZIP  and the file
  6039.     was still  in the  current directory).  This logic  has been changed
  6040.     and fixed;  MTA will  now validate  the supplied  directory and will
  6041.     abort  (before  the  conversion)  if  there  is an invalid directory
  6042.     supplied;
  6043.  
  6044.   ■ Previous versions  of MTA could  not work with  generic directories.
  6045.     You  always  had  to  include  the  full pathname (directory and the
  6046.     drive   name).   When   reading   options   from   MTA.CTL  and  the
  6047.     command-line, MTA will  now expand generic  paths (/M.. or  /Z\ZIP\)
  6048.     to full names, based on  the current directory and drive.  Be warned
  6049.     though.  If  the  generic  path  results in an expanded NON-existing
  6050.     path, MTA will abort with an error;
  6051.  
  6052.   ■ MTA would fail the extended test when ARJ files were converted  that
  6053.     contained files, archived with -t1. These files can be found in  the
  6054.     original ARJxxx.EXE distribution  file (just run  a verbose list  of
  6055.     this archive,  write down  the length  of all  files, decompress the
  6056.     file, run a  DIR and compare  the lengths) and  all other ARJ  files
  6057.     that are created with the  -t1 ARJ command-line parameter. MTA  will
  6058.     now ignore the extended test when dealing with such ARJ archives;
  6059.  
  6060.   ■ In certain cases, MTA would forget to clean the temporary  directory
  6061.     when an extended test failed. This is fixed;
  6062.  
  6063.   ■ MTA will now FULLY ignore the ARJ_SW environment variable. MTA  will
  6064.     pass a  command-line parameter  to ARJ  (2.21 and  higher) that will
  6065.     force ARJ NOT  to look at  this env.var.. All  additional options in
  6066.     this env.var. must be added to the ARJCompression option;
  6067.  
  6068.   ■ MTA will still give a beep EVEN when the WarningTime option was  set
  6069.     to 0. This is fixed;
  6070.  
  6071.   ■ CarryComment would  sometimes be unable  to find the  comment in the
  6072.     FILES.BBS alike file. Fixed;
  6073.  
  6074.   ■ The full-screen picklist would 'flicker' when you pressed F1  (help)
  6075.     more than once. Fixed;
  6076.  
  6077.   ■ Sometimes MTA would screw up  the first file inside a PAK  SFX file.
  6078.     This is fixed;
  6079.  
  6080.   ■ MTA  would truncate  the log-file  when it  became bigger  than 64K.
  6081.     This is fixed;
  6082.  
  6083.   ■ MTA  would consume  8K blocks  of conventional  memory when the TICK
  6084.     support was on. This is fixed;
  6085.  
  6086.   ■ The documented  /CO command-line parameter  (to overrule the  option
  6087.     ZOOCOMPRESSION) did cause MTA to  fail. It has now been  included in
  6088.     MTA.EXE under the name /CQ;
  6089.  
  6090.   ■ MTA would sometimes not  remove directories. This happened when  MTA
  6091.     needed to access various drives. This is fixed;
  6092.  
  6093.   ■ Sometimes  MTA  would  display  a  very huge number of  uncompressed
  6094.     bytes for ARJ files (causing MTA to skip the file if that number  of
  6095.     bytes was not available on the hard-disk). This is fixed;
  6096.  
  6097.   ■ Under  4DOS (4.0  and higher),  MTA would  show a  cursor after  the
  6098.     first MOVE. This is fixed. MTA will hide the cursor after each  call
  6099.     to an external program (4DOS is one of them);
  6100.  
  6101.   ■ Various problems  with TBSCAN 2.9,  3.1 and 3.2  are fixed (look  at
  6102.     the  new  command-line  examples  for  this scanner). When using MTA
  6103.     under  DesqView  (with  SHARE),  you  MUST  use TBSCAN 3.2 or higher
  6104.     because older versions will deny the removal of files and  directory
  6105.     that MTA  (not TBSCAN!!)  has created.  The 3.2  works fine with the
  6106.     new coding in MTA  if you (at least)  use the -compat option  of the
  6107.     TBSCAN program;
  6108.  
  6109.   ■ Various problems  with HTSCAN 1.6  (and lower). Some  of them caused
  6110.     by MTA (fixed) and one of them caused by HTSCAN. When HTSCAN has  to
  6111.     run in 200Kb or less, it would cause MTA to report that the  archive
  6112.     contained a virus. The author of HTSCAN will change this bug in  the
  6113.     next version  and MTA  can now  work with  HTSCAN's new error-levels
  6114.     because of a change in the VIRUSSCANNER option;
  6115.  
  6116.   ■ Added %D macro  in the VIRUSSCANNER option.  %P (as before) will  be
  6117.     expanded to the complete  directory to scan (without  filenames), %F
  6118.     will be  expanded to  the complete  directory plus  \*.*. %D will be
  6119.     expanded to the  last branch (node)  in the temporary  directory and
  6120.     is a relative directory. This  macro can be used in  complex network
  6121.     structures;
  6122.  
  6123.   ■ Mouse  support  in  the  main  MTA-body  is  removed.  It  is  still
  6124.     available in the full-screen  pick-list. The NOMOUSE option  and the
  6125.     /NOMOUSE command-line parameter are removed from MTA;
  6126.  
  6127.   ■ Older versions of  MTA would rename the  target file if a  file with
  6128.     the same name existed  on the target location.  You can now add  the
  6129.     OVERWRITEDUPLICATES option  to force  MTA to  overwrite such  files.
  6130.     The new target-file will overwrite a file with the same name in  the
  6131.     target directory;
  6132.  
  6133.   ■ The  /CTL  command-line  parameter  is  enhanced.  You can now  also
  6134.     supply a filename (without  path) if that file  can be found in  the
  6135.     DOS  PATH,  the  current  directory  or  the directory where MTA.EXE
  6136.     (MTAOVR.EXE) is found (last option only under DOS 3.xx and higher);
  6137.  
  6138.   ■ The EXCLUDEFILE  and DONOT options  now accept wildcards,  including
  6139.     the '=' wildcard (see documentation);
  6140.  
  6141.   ■ Remote  operations (introduced  in the  14.5x versions  of MTA)  was
  6142.     only  possible  when  the  /REMOTE  command-line parameter was used.
  6143.     The REMOTE option for MTA.CTL is added;
  6144.  
  6145.   ■ MTA  will  now  do  remote  logging (modem communications) when  the
  6146.     REMOTE option or  /REMOTE command-line parameter  is set along  with
  6147.     non-zero  values  for  BAUD  and  COM-port.  If  either of these two
  6148.     contains  a  zero  (/BAUD0  and/or  /COM0),  MTA will not use remote
  6149.     logging;
  6150.  
  6151.   ■ Added  the /ANS  command-line parameter.  Normally MTA  will do  its
  6152.     remote logging in ANSI-mode. When /ANS0 is used, MTA will use  plain
  6153.     ASCII.  /ANS1  and  higher  values  (up  to  /ANS9)  will cause ANSI
  6154.     logging;
  6155.  
  6156.   ■ Added  the  NOBEEP  option.  When  WarningTime is set to a  non-zero
  6157.     value (nice  when running  unattended BUT  WITH remote  logging) you
  6158.     can still shut down the beeps and bells;
  6159.  
  6160.   ■ Added  the  /PAUSE   command-line  parameter  (no  counterpart    in
  6161.     MTA.CTL).   When present,  MTA will  halt until  you press ESC after
  6162.     EACH call to an external program. Added for debugging;
  6163.  
  6164.   ■ Added coding so  you can abort MTA  when it is waiting  for a locked
  6165.     (shared) file. If you press CTRL-E, MTA will abort from the lock;
  6166.  
  6167.   ■ Added  the NOEMS  and NOXMS  options in  MTA.CTL and  the /NOEMS and
  6168.     /NOXMS command-line parameters, to force  MTA NOT to use EMS  and/or
  6169.     XMS while swapping itself from memory;
  6170.  
  6171.   ■ Changed the logging.  The following changes have  been made:
  6172.  
  6173.     - All  records   have   been   split   into   single-item     lines,
  6174.       containing the needed info in the smallest number of bytes;
  6175.  
  6176.     - The  errors are   now recorded  in   the normal   log-file. As   a
  6177.       result  of  this change, the  ERRORLOGPATH option is  removed from
  6178.       MTA;
  6179.  
  6180.     - MTA and MTL  work with  the new log. If you convert to  15.01, you
  6181.       must run  the previous  MTL version  (with log-compression) before
  6182.       you start  using MTA  and MTL  unless   you   do   not   need  the
  6183.       statistics  inside  the log-file;
  6184.  
  6185.     - MTA  now uses  its own  codes (MTL  will also  use them):
  6186.  
  6187.       * error message
  6188.       ! important  information
  6189.       $ extra      information
  6190.       = status     information
  6191.       ~ password   information
  6192.       # conversion information  (needed by MTL)
  6193.       @ MTL        information (created by MTL)
  6194.  
  6195.   ■ Changed   the syntax   of the   xxxPATH options   (see documentation
  6196.     for  the  current  format).  This  was   done to change the swapping
  6197.     function and  to   add   alternative   archiver  versions.    PLEASE
  6198.     READ   the documentation carefully !
  6199.  
  6200.   ■ Added a cheap  alternative to archive-marking (NOMARKED  and related
  6201.     options) with the ONLYNEWFILES  option and/or the /NEW  command-line
  6202.     parameter. Only files that are newer than the file-date of the  file
  6203.     FILES.MTA in the working directory, are converted. MTA will  (re)set
  6204.     the file FILES.MTA itself;
  6205.  
  6206.   ■ At the risk  of loosing some friend,  I include the following  text.
  6207.     It  has  become  general  practice  for  some BBS's to add their own
  6208.     AV-code to ARJ and  ZIP files. In my  views the AV-code is  meant to
  6209.     tell the user  that a certain  file is untouched  after it has  been
  6210.     created by the  author. When a  BBS includes AV-codes,  it will mean
  6211.     that the file is  untouched after it has  been created by the  SYSOP
  6212.     (not the author) and that  is ALMOST useless information. It  can be
  6213.     used  as  long  as  ORIGINAL  AV-codes  are left unaltered but it is
  6214.     misleading  users  when  original  AV-codes  ARE  altered. With this
  6215.     practice, it is almost useless  to keep AV codes inside  the archive
  6216.     because you (as user/sysop) only  have the advertisement of the  BBS
  6217.     as  added  value.  To  (partially)  overcome  this  problem, MTA now
  6218.     contains an option INCLUDEAVFILES. If this option is NOT present  in
  6219.     MTA.CTL and KEEPAV is set, all AV'ed files are still unaltered.   If
  6220.     you include one or more  INCLUDEAVFILES options, and KEEPAV is  set,
  6221.     MTA will only keep the AV code for the files that match one or  more
  6222.     of  the  INCLUDEAVFILES  file-masks.  ALL  other AV'ed files will be
  6223.     converted EVEN when  KEEPAV is set.  One of the  next minor versions
  6224.     of MTA will extend this option  in a very dynamic (and more  secure)
  6225.     way;
  6226.  
  6227.   ■ Added  dynamic swapping.  In the  previous versions  you could  only
  6228.     tell to ALWAYS swap before the  call to another program was made  or
  6229.     to NEVER swap before the call  to another program was made.   Though
  6230.     this  function  was  variable  for  each  different  (de)compression
  6231.     program, it was somewhat rough. You can now supply a minimum  number
  6232.     of bytes that  must be available  in memory (conventional).  If this
  6233.     number of  bytes (or  more) is  available, MTA  will NOT swap itself
  6234.     out of  the way.  If it  isn't available,  MTA WILL  swap before the
  6235.     call  is  made.  Dynamic  swapping  is  now available in all xxxPATH
  6236.     options  (as  a  replacement  for  the  older  SWAP  value  in these
  6237.     options) and is added to the VIRUSSCANNER and all EXITxxx options;
  6238.  
  6239.   ■ Removed  the NOSWAP  option from  MTA. It  became obsolete after the
  6240.     introduction of dynamic swapping;
  6241.  
  6242.   ■ Added alternative archive-program  versions in the xxxPATH  options.
  6243.     Added the  /ALT command-line  parameter to  activate the alternative
  6244.     versions. See the chapter about the usage of alternative versions;
  6245.  
  6246.   ■ Added  support  for  SFX  (TARGET!!)  files. You can now create  SFX
  6247.     files as  the target.  To support  this option,  the values  ZIPSFX,
  6248.     ARJSFX,  LZHSFX  and  PAKSFX  can  be  used  as  the  value  for the
  6249.     COMPRESSIONTYPE  option.  Also  the  /ZIPSFX,  /ARJSFX,  /LZHSFX and
  6250.     /PAKSFX command-line parameters can now be used. Also added are  the
  6251.     ASFCOMPRESSION,  LSFCOMPRESSION  and  ZSFCOMPRESSION  options to add
  6252.     extra parameters to the  call to the archive-program  (when creating
  6253.     SFX files). The /CJS, /CLS  and /CZS command-line parameters can  be
  6254.     used  to   over-  rule   the  ASFCOMPRESSION,   LSFCOMPRESSION   and
  6255.     ZSFCOMPRESSION options.   The ZIP2EXEPATH option  is added to  point
  6256.     to the ZIP2EXE.EXE program;
  6257.  
  6258.   ■ MTA will also convert  archives inside archives (arc-in-arc) to  SFX
  6259.     files (when one of the xxxSFX  options is set) so the customer  does
  6260.     not need any decompression program to decompress the file;
  6261.  
  6262.   ■ Added support for GIFLITE.  You can now convert normal  GIF-files to
  6263.     the GIFLITE format when the  target is set to GIFLITE.  When running
  6264.     a  GIF->GIFLITE  conversion,  no  normal  archives  can (or will) be
  6265.     converted  so  'MTA  *.ZIP  /GIFLITE'  will  have  no  meaning.   To
  6266.     implement   this    function,    the   options    GIFLITEPATH    and
  6267.     GIFLITECOMPRESSION are added as well as the 'GIFLITE' value for  the
  6268.     COMPRESSIONTYPE  option.    The  /CGL   and  /GIFLITE   command-line
  6269.     parameters are also added;
  6270.  
  6271.   ■ Added support  for GIFTEST. You  can now test  GIF-files (normal and
  6272.     lite) when the target is set  to GIF. When running GIF->GIF test  no
  6273.     normal archives can (or will) be converted so 'MTA *.ZIP /GIF'  will
  6274.     have  no   meaning.  To   implement  this   function,  the   options
  6275.     GIFTESTPATH and GTECOMPRESSION are added as well as the 'GIF'  value
  6276.     for the  COMPRESSIONTYPE option.   The /CGT  and /GIF  command- line
  6277.     parameters are also added;
  6278.  
  6279.   ■ Added support for JPEG. You can now convert normal GIF-files to  the
  6280.     JPEG format  when the  target is  set to  GIF2JPG and  you can  also
  6281.     convert JPEG  (.JPG) files  back to  GIF when  the target  is set to
  6282.     JPG2GIF.  When  running  a  GIF->JPEG  or  JPEG->GIF  conversion, no
  6283.     normal archives can (or will) be converted, so 'MTA *.ARJ  /GIF2JPG'
  6284.     will have  no meaning.   To implement  these functions,  the options
  6285.     GIF2JPGPATH,  JPG2GIFPATH,  G2JCOMPRESSION  and  J2GCOMPRESSION  are
  6286.     added,  as  well  as  the   values  GIF2JPG  and  JPG2GIF  for   the
  6287.     COMPRESSIONTYPE  option.   The  /C2J,  /C2G,  /GIF2JPG  and /JPG2GIF
  6288.     command-line parameters are also added;
  6289.  
  6290.   ■ Added the MAXGIFDIM option to narrow the selection of GIF-files  for
  6291.     GIFLITE (unregistered version of GIFLITE);
  6292.  
  6293.   ■ Changed the full-screen picklist  to include the correct files  when
  6294.     one of the GIF-alike  options is used in  MTA (you will now  see the
  6295.     usable GIF/JPG files and not archives);
  6296.  
  6297.   ■ Changed the  help-display (MTA /?)  to reflect the  new command-line
  6298.     parameters in MTA 15.01;
  6299.  
  6300.   ■ Added  logic  and  support  for  the  new  PKZIP  (1.93+)  deflating
  6301.     algorithm. MTA  will detect  these files  and will  convert them  if
  6302.     the   newer    PKZIP/PKUNZIP      is    used      (ZIPVERSION    and
  6303.     PKZIPPATH/PKUNZIPPATH set  to  1.93/2.01  values)  or  will   report
  6304.     the need  for a  higher version  of PK(UN)ZIP  is you  still use the
  6305.     1.10 (or lower);
  6306.  
  6307.   ■ /UPGRADE is changed. It can  now be used to convert from  PKZIP 1.xx
  6308.     type of archives to 2.xx (it was set to convert from 0.xx to 1.xx);
  6309.  
  6310.   ■ Added support and logic for  the new ARJ (2.30+). MTA will  not con-
  6311.     vert  backup  files  in  ARJ  archives.  You can add the SKIPBACKUPS
  6312.     option in MTA.CTL  (/SBA command-line parameter)  in which case  MTA
  6313.     will  skip  ZOO  and  ARJ  archives  that contain backup-versions of
  6314.     files. Also, the  extended testing will  be skipped if  these backup
  6315.     version are available  in the archive.  With the last  change, it is
  6316.     possible to convert  ARJ files with  backups (and also  ZOO for that
  6317.     matter). For ARJ you can choose to do a normal conversion (in  which
  6318.     case  the  backup  files  are  removed)  or  you  can  use a special
  6319.     command-line parameter in the  ARJCOMPRESSION option, in which  case
  6320.     ARJ will rename all backup-versions with a special extension;
  6321.  
  6322.   ■ Added a graphical bar when parsing the MTA.CTL;
  6323.  
  6324.  ┌───────┬────────────────────────────┐
  6325.  │ 15.02 │ Bug & minor release        │
  6326.  └───────┴────────────────────────────┘
  6327.   ■ MTA would report 'duplicate  file, extension changed to ...'  when a
  6328.     file was  checked with  the /SIM  mode. This  could alarm users that
  6329.     saw the message at the remote side. Fixed;
  6330.  
  6331.   ■ MTA would report 'Unable  to RmDir/MkDir/ChDir to .........' when  a
  6332.     file was  checked with  the /SIM  mode. This  could alarm users that
  6333.     saw the message at the remote side. Fixed;
  6334.  
  6335.   ■ MTA would report 'SIMULATE  MODE' and not 'SIMULATE MODE  [OVERLAY]'
  6336.     on the main  screen when the  overlayed version and  /SIM were used.
  6337.     Fixed;
  6338.  
  6339.   ■ MTA would report 'DATETEST  MODE' and not 'DATETEST MODE  [OVERLAY]'
  6340.     on the main  screen when the  overlayed version and  /SIM were used.
  6341.     Fixed;
  6342.  
  6343.   ■ MTA  /? would  always cause  a GOMTA.BAT  in the  current directory,
  6344.     even when no changes were made to the note-pad;
  6345.  
  6346.   ■ The pick-list would  display ALL files when  /GIF was used. This  is
  6347.     fixed so only .GIF files are showed;
  6348.  
  6349.   ■ Some cosmetic changes in the copyrights for the remote display;
  6350.  
  6351.   ■ The overlay  algorithm is somewhat  changed to speed  up the parsing
  6352.     of the MTA.CTL alike file;
  6353.  
  6354.   ■ Added the RemoteColor option  in MTA.CTL to alter the  remote colors
  6355.     so they can match  the BBS colors. The  default colors are the  same
  6356.     as the default colors for FileDoor <tm>;
  6357.  
  6358.  
  6359.  MTA is tested with PKWare PKPAK version 3.61, PKWare ZIP version  1.10,
  6360.  PKWare ZIP version  1.93a, NoGate PAK  version 2.51, ARC  version 6.02,
  6361.  ZOO version 2.10,  DWC version 5.10,  LHarc version 1.13c/d/2.13,  LARC
  6362.  version 3.33, MDCD  version 1.0, ARJ  version 2.22,  ARJ  version 2.30,
  6363.  HYPER  version  25,  PKLITE  release  1.13,  GIFLITE version 1.41, JPEG
  6364.  version 1.5 and GIFTEST version 4.0ß;
  6365.  
  6366.  ┌───────┬────────────────────────────┐
  6367.  │ 15.05 │ Minor Release              │
  6368.  └───────┴────────────────────────────┘
  6369.   ■ MTA would report 'no compressor available' or something alike,  when
  6370.     ZIP files were involved. This could happen when you did not  include
  6371.     a ZIP2EXEPath option in MTA.CTL and/or ZIP2EXE.EXE was not found  in
  6372.     the DOS-path. This is fixed;
  6373.  
  6374.   ■ JPG2GIF would report  'no compressor' available or  something alike,
  6375.     when JPG  files were  involved. This  could happen  when you did not
  6376.     include a GIFTESTPath option  in MTA.CTL and/or GIFTEST.EXE  was not
  6377.     found in the DOS-path. This is fixed;
  6378.  
  6379.   ■ Under  some conditions  (errors), the  'bar' would  not display  the
  6380.     correct  values,  neither  did  some  of  the  counters.  Also  when
  6381.     multiple files were  converted and one  or more files  were invalid,
  6382.     the ratio (percentage) could  show incorrect values. This  is fixed.
  6383.     MTA will now  display counters for  invalid files (in  red) also and
  6384.     the normal  counters, ratio  and 'bar'  are modified  in the correct
  6385.     way;
  6386.  
  6387.   ■ Fixed a problem  with /P (toggle logging).  This was still a  toggle
  6388.     but could result in  errors. /P can now  only be used to  switch any
  6389.     current logging to OFF. Using the log-file, must be set in MTA.CTL;
  6390.  
  6391.   ■ Added a /NVI command-line option. When used, the virus-scanning  (of
  6392.     ALL configured scanners) will be skipped;
  6393.  
  6394.   ■ Enhanced the IncludeAVFile option. You can now (optionally)  include
  6395.     the AV-number  (security env.  number) of  the filemask.  It is  now
  6396.     possible to  filter the  correct files  from the  ones that  are not
  6397.     from the  original authors.  In the  past IncludeAVFiles  PKLTE*.EXE
  6398.     would cause PKLT113.EXE to pass  (keep its AV, when KeepAV  was also
  6399.     set) even when RVH012 was the  one that added the AV-code (and  that
  6400.     is  NOT  PKWare).  Now  you  can  add  the PKW655 code to the option
  6401.     (IncludeAVFile PKLTE*.* PKW655) to force only the keeping of the  AV
  6402.     is the file matches PKLTE*.* AND the AV-code is PKW655). Also  masks
  6403.     for the AV-code (numeric/alphanumeric masks) can be used;
  6404.  
  6405.   ■ Added the AVLogPath option which causes a log-file to be  maintained
  6406.     by MTA, that included AV-numbers  and their names (like 0000  Robert
  6407.     K Jung or PKW655 PKWare Inc). This file can be maintained by MTL;
  6408.  
  6409.   ■ Added several log-records to the normal log that have to do with  AV
  6410.     (security env.)  coded. The  values will  only be  used when  either
  6411.     AVLogPath is set OR  at least one or  more AV-codes are supplied  as
  6412.     parameters for the IncludeAVPath option(s);
  6413.  
  6414.   ■ Added the test for  the MTAOVRSZ environment variable (only  overlay
  6415.     version).  If  present  and  containing  a numeric value, this value
  6416.     will be used as overlay buffer. Using number above 56000 will  cause
  6417.     MTAOVR to run faster but will also cause MTAOVR to use more  conven-
  6418.     tional memory;
  6419.  
  6420.  ┌───────┬────────────────────────────┐
  6421.  │ 15.06 │ Minor Release              │
  6422.  └───────┴────────────────────────────┘
  6423.   ■ Fixed a problem with a  runtime error 200 when no valid  files could
  6424.     be processed. This is fixed (both overlay and normal version);
  6425.  
  6426.   ■ Changed the DoNot  option in a way  that you can also  supply paths.
  6427.     It is now  possible to exclude  complete directories with  the DoNot
  6428.     statement  (e.g.  DoNot  E:\TUP\DONOT\*.*)  or  partial  directories
  6429.     (e.g.  DoNot  E:\TUP\SOME\DONOT\*.ARJ).  This  option  also comes in
  6430.     handy in combination with the QBBSPaths and RAPaths option(s);
  6431.  
  6432.   ■ Added a ChildTouch  option so you can  use another type of  touching
  6433.     for nested archives;
  6434.  
  6435.  ┌───────┬────────────────────────────┐
  6436.  │ 15.07 │ Minor Release              │
  6437.  └───────┴────────────────────────────┘
  6438.   ■ Fixed all problems with READONLY, HIDDEN and SYSTEM files. MTA would
  6439.     not copy, delete, rename  and/or  move these files. Though they will
  6440.     not show up  in  archives very frequently, some users complained. It
  6441.     was a bug and therefore fixed;
  6442.  
  6443.   ■ Added support  for  those  virusscanners  that can only work good on
  6444.     complete  drives. Scanners  like  Central  Point  Software CPAV (1.2
  6445.     and up) can  now  be  run  in batch-mode but will run best when they
  6446.     can scan a  full  drive. In  these  cases  you  should use the SUBST
  6447.     support of  MTA (only  if  you have troubles with it, you SHOULD use
  6448.     this feature, if you HAVE problems, tell me);
  6449.  
  6450.   ■ Added examples (tested  by me or others) for Dr.Solomon's virus scan
  6451.     (FINDVIRU) and  Central  Point Software's CPAV (only 1.2 and higher,
  6452.     1.0 does  not  return  errorlevels  and I skipped 1.1, so don't know
  6453.     if this version already returns errorlevels);
  6454.  
  6455.   ■ The %D macro in the VirusScanner option was not included in the DOCs
  6456.     (it is now) and there is a much better description of all the macros
  6457.     that you can use in this option (including the new %S and %L macro);
  6458.  
  6459.  ┌───────┬────────────────────────────┐
  6460.  │ 15.07 │ Bug (?) Release            │
  6461.  └───────┴────────────────────────────┘
  6462.   ■ Reports got in  from  users about MTA in a OS/2 2.0ß DOS box. MTA is
  6463.     not able to find any file that the  user wants to select. This nasty
  6464.     problem *looks*  like a problem with OS/2 2.0 because the normal DOS
  6465.     (ALSO IBM PC-DOS 5.0) works fine and the problems  involved  have to
  6466.     do with DOCUMENTED interrupts and NORMAL  Turbo  Pascal  processing.
  6467.     Thanks to some willin beta-testers I was able  to track the  problem
  6468.     down. This release contains a work-around that even causes MTA to be
  6469.     somewhat smaller and still giving the same functions. Under OS/2 2.0
  6470.     DOS boxes it *should* work again (as it did with beta-testers). Look
  6471.     into HELP__ME.MTA for questions about OS/2 2.0ß because  I don't run
  6472.     this operating system and must rely on the input from users who do !
  6473.  
  6474.  
  6475.  ┌───────┬────────────────────────────┐
  6476.  │ 15.10 │ Minor Release              │
  6477.  └───────┴────────────────────────────┘
  6478.  Several requests from users have  been addressed in this release.  Also
  6479.  please read the Q&A.MTA file (if it is present inside the archive).
  6480.  
  6481.   ■ Fixed another file-selection mask  (OS2 problem) in MTA.CH1. Also  a
  6482.     couple of OS2 beta-testers have  reported me that IBM has  addressed
  6483.     the problem  and that  there is  a fix-file  in the  later OS2 betas
  6484.     that can solve the problem;
  6485.  
  6486.   ■ Added the FileIDDiz option.  When active, it will store  the comment
  6487.     inside this  file into  memory. This  comment can  later be added to
  6488.     FILES.BBS (when ADDFilesBBS  is on) and/or  into the semaphore  file
  6489.     for the protocol-driver (StoreComment and /STOCOM, see later);
  6490.  
  6491.   ■ StoreSize, StoreName  (see later) and  StoreComment (see later)  can
  6492.     now also work  when remote operation  is NOT the  case. Normally you
  6493.     should  use  the  command-line  options  (/STOSIZ, /STONAM, /STOCOM)
  6494.     when you run MTA under a  door (FileDoor). When you set the  options
  6495.     in MTA.CTL  they will  work also  when remote  operation is  NOT the
  6496.     case (again,  unless you  toggle the  options to  OFF with  the same
  6497.     command-line parameters as mentioned before);
  6498.  
  6499.   ■ StoreSize  (/STOSIZ)  has  been  expanded.  You  can now supply  the
  6500.     extension of the file (normally xxxxxxxx.XS1) when the caller  needs
  6501.     to access another extension  (FileDoor 2.03 will need  the extension
  6502.     F$D);
  6503.  
  6504.   ■ Added  the StoreName  (/STONAM) option.  It will  create a file with
  6505.     old and new names that can be used by  a  protocol-driver  like  the
  6506.     FileDoor program. Only FileDoor 3.01 (and up)  will  work  with this
  6507.     semaphore file;
  6508.  
  6509.   ■ Added the StoreComment (/STOCOM) option. It will create a file  with
  6510.     comments from the header  or FILE_ID.DIZ file. It  can be used by  a
  6511.     protocol driver to overrule (supply) the comment of uploaded  files;
  6512.  
  6513.   ■ Added  SubstOn  and  SubstOff  options  to  overrule  the   internal
  6514.     sequence  that  MTA  uses  when  paging directories to a substituted
  6515.     drive;
  6516.  
  6517.   ■ The warning for using a Substituted drive is reversed. You will  now
  6518.     get a flashy warning when NOT using a substituted drive;
  6519.  
  6520.   ■ Added  the %T  macro in  all exit-calls  that can  be used to assign
  6521.     different  batch-files  for  different  tasks (when running multiple
  6522.     tasks);
  6523.  
  6524.   ■ The call to  LABEL.COM/EXE has been removed.  MTA will now use  some
  6525.     internal coding to reset the volume-label to the original label  (or
  6526.     a dummy when no label was set), when archives contain volume  labels
  6527.     inside;
  6528.  
  6529.   ■ The  CarryComment  option  did  only  allow  the first 255 bytes  of
  6530.     archive-comments to  be carried  over to  the new  archive. This has
  6531.     been enhanced to  64K of comment.  There are several  special tricks
  6532.     involved to  deal with  ARJ-comments in  this matter  because of the
  6533.     'multi-platform' 'compatible' matter  ARJ stores the  comment inside
  6534.     the  archives  (removing  part  of  the CR/LF sequence, resulting in
  6535.     problems when carried over to other archivers);
  6536.  
  6537.  
  6538.  5.4 Copyright, Trademarks
  6539.  ───────────────────────────────────────────────────────────────────────
  6540.  PKPAK, PKUNPAK, PKZIP and PKUNZIP are trademarks of PKWare Inc.
  6541.  PKLITE        is a trademark of PKWare Inc.
  6542.  PAK           is a trademark of NoGate Consulting.
  6543.  ARC and XARC  are trademarks of SEA inc.
  6544.  ZOO           is a trademark of R. Dhesi.
  6545.  DWC           is a trademark of Dean W. Cooper
  6546.  LZH and LHarc are trademarks of Yoshi;
  6547.  LZS and LARC  are trademarks of K.Miki H.Okumura and K.Masuyama
  6548.  MD            is a trademark of Michael Davenport
  6549.  ARJ           is a trademark of Robert K. Jung
  6550.  HYPER         is a trademark of Peter Sawatzki and Klaus Peter Nischke
  6551.  CRA           is a trademark of DISP and donated to public domain
  6552.  Windows       is a trademark of The Microsoft Corporation
  6553.  4Dos          is a trademark of J.P. Software / R.C. Conn and T. Rawson
  6554.  FrontDoor     is a trademark of J. Homrichhausen
  6555.  SCAN          is a trademark of McAfee Associates
  6556.  TBScan        is a trademark of Frans Veldman / ESaSS B.V.
  6557.  HTScan        is a trademark of Harry Thijssen
  6558.  VIRX          is a trademark of Microcom Software Division
  6559.  CPAV          is a trademark of Central Point Software
  6560.  FINDVIRU      is a trademark of S&S International
  6561.  Dr. Solomon   is a trademark of S&S International
  6562.  VALIDATE      is a trademark of McAfee Associates
  6563.  QuickBBS      is a trademark of the QuickBBS group Inc.
  6564.  Remote Access is a trademark of Continental Software
  6565.  TICK          is a trademark of Berry Geller
  6566.  FES           is a trademark of Frank Ploenissen
  6567.  GIFLITE       is a trademark of Tsung Hu
  6568.  JPEG          is a trademark of Handmade Software Inc.
  6569.  GIFTEST       is a trademark of Dave Navarro Jr.
  6570.  OS/2          is a trademark of International Business Machines (IBM)
  6571.  PC-DOS        is a trademark of International Business Machines (IBM)
  6572.  
  6573.  MTA is written  in Turbo Pascal  6.0, with help  of the Turbo  Debugger
  6574. │2.5 and  makes extensive  use of  Object Professional  1.14 and OPCFI V
  6575. │15.01.    Some  routines   are  obtained   from  TurboPower's    Asynch
  6576. │Professional  1.03.   Both  STRG  and  SYS  (6.1  and  6.0a, commercial
  6577. │version) are included. Sources are edited with BRIEF 3.1;
  6578.  
  6579.  Turbo Pascal        is a trademark  of Borland International
  6580.  Turbo Debugger      is a trademark  of Borland International
  6581.  Object Professional is a trademark  of TurboPower Inc.
  6582.  Asynch Professional is a trademark  of TurboPower Inc.
  6583.  OPCFI               is a trademark  of Robert W. van Hoeven
  6584.  STRG and SYS        are  trademarks of Eagle Performance Software
  6585.  BRIEF               is a trademark  SolutionSystem
  6586.  
  6587.  ========================= END OF DOCUMENT =============================
  6588.